89009 lines
4.7 MiB
89009 lines
4.7 MiB
<?xml version="1.0"?>
|
|
<!-- This file was automatically generated from C sources - DO NOT EDIT!
|
|
To affect the contents of this file, edit the original C definitions,
|
|
and/or use gtk-doc annotations. -->
|
|
<repository xmlns="http://www.gtk.org/introspection/core/1.0" xmlns:c="http://www.gtk.org/introspection/c/1.0" xmlns:glib="http://www.gtk.org/introspection/glib/1.0" version="1.2">
|
|
<include name="GObject" version="2.0"/>
|
|
<package name="gio-2.0"/>
|
|
<package name="gio-unix-2.0"/>
|
|
<c:include name="gio/gdesktopappinfo.h"/>
|
|
<c:include name="gio/gfiledescriptorbased.h"/>
|
|
<c:include name="gio/gio.h"/>
|
|
<c:include name="gio/gunixconnection.h"/>
|
|
<c:include name="gio/gunixcredentialsmessage.h"/>
|
|
<c:include name="gio/gunixfdlist.h"/>
|
|
<c:include name="gio/gunixfdmessage.h"/>
|
|
<c:include name="gio/gunixinputstream.h"/>
|
|
<c:include name="gio/gunixmounts.h"/>
|
|
<c:include name="gio/gunixoutputstream.h"/>
|
|
<c:include name="gio/gunixsocketaddress.h"/>
|
|
<namespace name="Gio" version="2.0" shared-library="libgio-2.0.so.0" c:identifier-prefixes="G" c:symbol-prefixes="g">
|
|
<function-macro name="ACTION" c:identifier="G_ACTION" introspectable="0">
|
|
<source-position filename="gaction.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ACTION_GET_IFACE" c:identifier="G_ACTION_GET_IFACE" introspectable="0">
|
|
<source-position filename="gaction.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ACTION_GROUP" c:identifier="G_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gactiongroup.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ACTION_GROUP_GET_IFACE" c:identifier="G_ACTION_GROUP_GET_IFACE" introspectable="0">
|
|
<source-position filename="gactiongroup.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ACTION_MAP" c:identifier="G_ACTION_MAP" introspectable="0">
|
|
<source-position filename="gactionmap.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ACTION_MAP_GET_IFACE" c:identifier="G_ACTION_MAP_GET_IFACE" introspectable="0">
|
|
<source-position filename="gactionmap.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APPLICATION" c:identifier="G_APPLICATION" introspectable="0">
|
|
<source-position filename="gapplication.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APPLICATION_CLASS" c:identifier="G_APPLICATION_CLASS" introspectable="0">
|
|
<source-position filename="gapplication.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APPLICATION_COMMAND_LINE" c:identifier="G_APPLICATION_COMMAND_LINE" introspectable="0">
|
|
<source-position filename="gapplicationcommandline.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APPLICATION_COMMAND_LINE_CLASS" c:identifier="G_APPLICATION_COMMAND_LINE_CLASS" introspectable="0">
|
|
<source-position filename="gapplicationcommandline.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APPLICATION_COMMAND_LINE_GET_CLASS" c:identifier="G_APPLICATION_COMMAND_LINE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gapplicationcommandline.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APPLICATION_GET_CLASS" c:identifier="G_APPLICATION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gapplication.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APP_INFO" c:identifier="G_APP_INFO" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APP_INFO_GET_IFACE" c:identifier="G_APP_INFO_GET_IFACE" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APP_INFO_MONITOR" c:identifier="G_APP_INFO_MONITOR" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="332"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APP_LAUNCH_CONTEXT" c:identifier="G_APP_LAUNCH_CONTEXT" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APP_LAUNCH_CONTEXT_CLASS" c:identifier="G_APP_LAUNCH_CONTEXT_CLASS" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="APP_LAUNCH_CONTEXT_GET_CLASS" c:identifier="G_APP_LAUNCH_CONTEXT_GET_CLASS" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="42"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ASYNC_INITABLE" c:identifier="G_ASYNC_INITABLE" introspectable="0">
|
|
<source-position filename="gasyncinitable.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ASYNC_INITABLE_GET_IFACE" c:identifier="G_ASYNC_INITABLE_GET_IFACE" introspectable="0">
|
|
<source-position filename="gasyncinitable.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ASYNC_RESULT" c:identifier="G_ASYNC_RESULT" introspectable="0">
|
|
<source-position filename="gasyncresult.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ASYNC_RESULT_GET_IFACE" c:identifier="G_ASYNC_RESULT_GET_IFACE" introspectable="0">
|
|
<source-position filename="gasyncresult.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<interface name="Action" c:symbol-prefix="action" c:type="GAction" glib:type-name="GAction" glib:get-type="g_action_get_type" glib:type-struct="ActionInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4466">#GAction represents a single named action.
|
|
|
|
The main interface to an action is that it can be activated with
|
|
g_action_activate(). This results in the 'activate' signal being
|
|
emitted. An activation has a #GVariant parameter (which may be
|
|
%NULL). The correct type for the parameter is determined by a static
|
|
parameter type (which is given at construction time).
|
|
|
|
An action may optionally have a state, in which case the state may be
|
|
set with g_action_change_state(). This call takes a #GVariant. The
|
|
correct type for the state is determined by a static state type
|
|
(which is given at construction time).
|
|
|
|
The state may have a hint associated with it, specifying its valid
|
|
range.
|
|
|
|
#GAction is merely the interface to the concept of an action, as
|
|
described above. Various implementations of actions exist, including
|
|
#GSimpleAction.
|
|
|
|
In all cases, the implementing class is responsible for storing the
|
|
name of the action, the parameter type, the enabled state, the
|
|
optional state type and the state and emitting the appropriate
|
|
signals when these change. The implementor is responsible for filtering
|
|
calls to g_action_activate() and g_action_change_state() for type
|
|
safety and for the state being enabled.
|
|
|
|
Probably the only useful thing to do with a #GAction is to put it
|
|
inside of a #GSimpleActionGroup.</doc>
|
|
<source-position filename="gaction.h" line="57"/>
|
|
<function name="name_is_valid" c:identifier="g_action_name_is_valid" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10682">Checks if @action_name is valid.
|
|
|
|
@action_name is valid if it consists only of alphanumeric characters,
|
|
plus '-' and '.'. The empty string is not a valid action name.
|
|
|
|
It is an error to call this function with a non-utf8 @action_name.
|
|
@action_name must not be %NULL.</doc>
|
|
<source-position filename="gaction.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10694">%TRUE if @action_name is valid</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10684">an potential action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="parse_detailed_name" c:identifier="g_action_parse_detailed_name" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10699">Parses a detailed action name into its separate name and target
|
|
components.
|
|
|
|
Detailed action names can have three formats.
|
|
|
|
The first format is used to represent an action name with no target
|
|
value and consists of just an action name containing no whitespace
|
|
nor the characters ':', '(' or ')'. For example: "app.action".
|
|
|
|
The second format is used to represent an action with a target value
|
|
that is a non-empty string consisting only of alphanumerics, plus '-'
|
|
and '.'. In that case, the action name and target value are
|
|
separated by a double colon ("::"). For example:
|
|
"app.action::target".
|
|
|
|
The third format is used to represent an action with any type of
|
|
target value, including strings. The target value follows the action
|
|
name, surrounded in parens. For example: "app.action(42)". The
|
|
target value is parsed using g_variant_parse(). If a tuple-typed
|
|
value is desired, it must be specified in the same way, resulting in
|
|
two sets of parens, for example: "app.action((1,2,3))". A string
|
|
target can be specified this way as well: "app.action('target')".
|
|
For strings, this third format must be used if * target value is
|
|
empty or contains characters other than alphanumerics, '-' and '.'.</doc>
|
|
<source-position filename="gaction.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10731">%TRUE if successful, else %FALSE with @error set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="detailed_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10701">a detailed action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="action_name" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10702">the action name</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
<parameter name="target_value" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10703">the target value, or %NULL for no target</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="print_detailed_name" c:identifier="g_action_print_detailed_name" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10736">Formats a detailed action name from @action_name and @target_value.
|
|
|
|
It is an error to call this function with an invalid action name.
|
|
|
|
This function is the opposite of g_action_parse_detailed_name().
|
|
It will produce a string that can be parsed back to the @action_name
|
|
and @target_value by that function.
|
|
|
|
See that function for the types of strings that will be printed by
|
|
this function.</doc>
|
|
<source-position filename="gaction.h" line="93"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10752">a detailed format string</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10738">a valid action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="target_value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10739">a #GVariant target value, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="activate" invoker="activate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10164">Activates the action.
|
|
|
|
@parameter must be the correct type of parameter for the action (ie:
|
|
the parameter type given at construction time). If the parameter
|
|
type was %NULL then @parameter must also be %NULL.
|
|
|
|
If the @parameter GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gaction.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10166">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10167">the parameter to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="change_state" invoker="change_state" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10181">Request for the state of @action to be changed to @value.
|
|
|
|
The action must be stateful and @value must be of the correct type.
|
|
See g_action_get_state_type().
|
|
|
|
This call merely requests a change. The action may refuse to change
|
|
its state or may change its state to something other than @value.
|
|
See g_action_get_state_hint().
|
|
|
|
If the @value GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gaction.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10183">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10184">the new state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_enabled" invoker="get_enabled" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10201">Checks if @action is currently enabled.
|
|
|
|
An action must be enabled in order to be activated or in order to
|
|
have its state changed from outside callers.</doc>
|
|
<source-position filename="gaction.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10210">whether the action is enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10203">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_name" invoker="get_name" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10215">Queries the name of @action.</doc>
|
|
<source-position filename="gaction.h" line="45"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10221">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10217">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_parameter_type" invoker="get_parameter_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10226">Queries the type of the parameter that must be given when activating
|
|
@action.
|
|
|
|
When activating the action using g_action_activate(), the #GVariant
|
|
given to that function must be of the type returned by this function.
|
|
|
|
In the case that this function returns %NULL, you must not give any
|
|
#GVariant, but %NULL instead.</doc>
|
|
<source-position filename="gaction.h" line="46"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10239">the parameter type</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10228">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_state" invoker="get_state" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10244">Queries the current state of @action.
|
|
|
|
If the action is not stateful then %NULL will be returned. If the
|
|
action is stateful then the type of the return value is the type
|
|
given by g_action_get_state_type().
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gaction.h" line="51"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10257">the current state of the action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10246">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_state_hint" invoker="get_state_hint" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10262">Requests a hint about the valid range of values for the state of
|
|
@action.
|
|
|
|
If %NULL is returned it either means that the action is not stateful
|
|
or that there is no hint about the valid range of values for the
|
|
state of the action.
|
|
|
|
If a #GVariant array is returned then each item in the array is a
|
|
possible value for the state. If a #GVariant pair (ie: two-tuple) is
|
|
returned then the tuple specifies the inclusive lower and upper bound
|
|
of valid values for the state.
|
|
|
|
In any case, the information is merely a hint. It may be possible to
|
|
have a state value outside of the hinted range and setting a value
|
|
within the range may fail.
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gaction.h" line="48"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10285">the state range hint</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10264">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_state_type" invoker="get_state_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10290">Queries the type of the state of @action.
|
|
|
|
If the action is stateful (e.g. created with
|
|
g_simple_action_new_stateful()) then this function returns the
|
|
#GVariantType of the state. This is the type of the initial value
|
|
given as the state. All calls to g_action_change_state() must give a
|
|
#GVariant of this type and g_action_get_state() will return a
|
|
#GVariant of the same type.
|
|
|
|
If the action is not stateful (e.g. created with g_simple_action_new())
|
|
then this function will return %NULL. In that case, g_action_get_state()
|
|
will return %NULL and you must not call g_action_change_state().</doc>
|
|
<source-position filename="gaction.h" line="47"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10307">the state type, if the action is stateful</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10292">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="activate" c:identifier="g_action_activate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10164">Activates the action.
|
|
|
|
@parameter must be the correct type of parameter for the action (ie:
|
|
the parameter type given at construction time). If the parameter
|
|
type was %NULL then @parameter must also be %NULL.
|
|
|
|
If the @parameter GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gaction.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10166">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10167">the parameter to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="change_state" c:identifier="g_action_change_state" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10181">Request for the state of @action to be changed to @value.
|
|
|
|
The action must be stateful and @value must be of the correct type.
|
|
See g_action_get_state_type().
|
|
|
|
This call merely requests a change. The action may refuse to change
|
|
its state or may change its state to something other than @value.
|
|
See g_action_get_state_hint().
|
|
|
|
If the @value GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gaction.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10183">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10184">the new state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_enabled" c:identifier="g_action_get_enabled" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10201">Checks if @action is currently enabled.
|
|
|
|
An action must be enabled in order to be activated or in order to
|
|
have its state changed from outside callers.</doc>
|
|
<source-position filename="gaction.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10210">whether the action is enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10203">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_action_get_name" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10215">Queries the name of @action.</doc>
|
|
<source-position filename="gaction.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10221">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10217">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_parameter_type" c:identifier="g_action_get_parameter_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10226">Queries the type of the parameter that must be given when activating
|
|
@action.
|
|
|
|
When activating the action using g_action_activate(), the #GVariant
|
|
given to that function must be of the type returned by this function.
|
|
|
|
In the case that this function returns %NULL, you must not give any
|
|
#GVariant, but %NULL instead.</doc>
|
|
<source-position filename="gaction.h" line="65"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10239">the parameter type</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10228">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_state" c:identifier="g_action_get_state" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10244">Queries the current state of @action.
|
|
|
|
If the action is not stateful then %NULL will be returned. If the
|
|
action is stateful then the type of the return value is the type
|
|
given by g_action_get_state_type().
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gaction.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10257">the current state of the action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10246">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_state_hint" c:identifier="g_action_get_state_hint" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10262">Requests a hint about the valid range of values for the state of
|
|
@action.
|
|
|
|
If %NULL is returned it either means that the action is not stateful
|
|
or that there is no hint about the valid range of values for the
|
|
state of the action.
|
|
|
|
If a #GVariant array is returned then each item in the array is a
|
|
possible value for the state. If a #GVariant pair (ie: two-tuple) is
|
|
returned then the tuple specifies the inclusive lower and upper bound
|
|
of valid values for the state.
|
|
|
|
In any case, the information is merely a hint. It may be possible to
|
|
have a state value outside of the hinted range and setting a value
|
|
within the range may fail.
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gaction.h" line="69"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10285">the state range hint</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10264">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_state_type" c:identifier="g_action_get_state_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10290">Queries the type of the state of @action.
|
|
|
|
If the action is stateful (e.g. created with
|
|
g_simple_action_new_stateful()) then this function returns the
|
|
#GVariantType of the state. This is the type of the initial value
|
|
given as the state. All calls to g_action_change_state() must give a
|
|
#GVariant of this type and g_action_get_state() will return a
|
|
#GVariant of the same type.
|
|
|
|
If the action is not stateful (e.g. created with g_simple_action_new())
|
|
then this function will return %NULL. In that case, g_action_get_state()
|
|
will return %NULL and you must not call g_action_change_state().</doc>
|
|
<source-position filename="gaction.h" line="67"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10307">the state type, if the action is stateful</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10292">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="enabled" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13">If @action is currently enabled.
|
|
|
|
If the action is disabled then calls to g_action_activate() and
|
|
g_action_change_state() have no effect.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="name" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25">The name of the action. This is mostly meaningful for identifying
|
|
the action once it has been added to a #GActionGroup. It is immutable.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="parameter-type" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35">The type of the parameter that must be given when activating the
|
|
action. This is immutable, and may be %NULL if no parameter is needed when
|
|
activating the action.</doc>
|
|
<type name="GLib.VariantType"/>
|
|
</property>
|
|
<property name="state" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="46">The state of the action, or %NULL if the action is stateless.</doc>
|
|
<type name="GLib.Variant"/>
|
|
</property>
|
|
<property name="state-type" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="55">The #GVariantType of the state that the action has, or %NULL if the
|
|
action is stateless. This is immutable.</doc>
|
|
<type name="GLib.VariantType"/>
|
|
</property>
|
|
</interface>
|
|
<record name="ActionEntry" c:type="GActionEntry">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="65">This struct defines a single action. It is for use with
|
|
g_action_map_add_action_entries().
|
|
|
|
The order of the items in the structure are intended to reflect
|
|
frequency of use. It is permissible to use an incomplete initialiser
|
|
in order to leave some of the later values as %NULL. All values
|
|
after @name are optional. Additional optional fields may be added in
|
|
the future.
|
|
|
|
See g_action_map_add_action_entries() for an example.</doc>
|
|
<source-position filename="gactionmap.h" line="73"/>
|
|
<field name="name" writable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="67">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</field>
|
|
<field name="activate">
|
|
<callback name="activate">
|
|
<source-position filename="gactionmap.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<type name="SimpleAction" c:type="GSimpleAction*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="parameter_type" writable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="75">the type of the parameter that must be passed to the
|
|
activate function for this action, given as a single
|
|
GVariant type string (or %NULL for no parameter)</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</field>
|
|
<field name="state" writable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="78">the initial state for this action, given in
|
|
[GVariant text format][gvariant-text]. The state is parsed
|
|
with no extra type information, so type tags must be added to
|
|
the string if they are necessary. Stateless actions should
|
|
give %NULL here.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</field>
|
|
<field name="change_state">
|
|
<callback name="change_state">
|
|
<source-position filename="gactionmap.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<type name="SimpleAction" c:type="GSimpleAction*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="3">
|
|
<type name="gsize" c:type="gsize"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<interface name="ActionGroup" c:symbol-prefix="action_group" c:type="GActionGroup" glib:type-name="GActionGroup" glib:get-type="g_action_group_get_type" glib:type-struct="ActionGroupInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4504">#GActionGroup represents a group of actions. Actions can be used to
|
|
expose functionality in a structured way, either from one part of a
|
|
program to another, or to the outside world. Action groups are often
|
|
used together with a #GMenuModel that provides additional
|
|
representation data for displaying the actions to the user, e.g. in
|
|
a menu.
|
|
|
|
The main way to interact with the actions in a GActionGroup is to
|
|
activate them with g_action_group_activate_action(). Activating an
|
|
action may require a #GVariant parameter. The required type of the
|
|
parameter can be inquired with g_action_group_get_action_parameter_type().
|
|
Actions may be disabled, see g_action_group_get_action_enabled().
|
|
Activating a disabled action has no effect.
|
|
|
|
Actions may optionally have a state in the form of a #GVariant. The
|
|
current state of an action can be inquired with
|
|
g_action_group_get_action_state(). Activating a stateful action may
|
|
change its state, but it is also possible to set the state by calling
|
|
g_action_group_change_action_state().
|
|
|
|
As typical example, consider a text editing application which has an
|
|
option to change the current font to 'bold'. A good way to represent
|
|
this would be a stateful action, with a boolean state. Activating the
|
|
action would toggle the state.
|
|
|
|
Each action in the group has a unique name (which is a string). All
|
|
method calls, except g_action_group_list_actions() take the name of
|
|
an action as an argument.
|
|
|
|
The #GActionGroup API is meant to be the 'public' API to the action
|
|
group. The calls here are exactly the interaction that 'external
|
|
forces' (eg: UI, incoming D-Bus messages, etc.) are supposed to have
|
|
with actions. 'Internal' APIs (ie: ones meant only to be accessed by
|
|
the action group implementation) are found on subclasses. This is
|
|
why you will find - for example - g_action_group_get_action_enabled()
|
|
but not an equivalent set() call.
|
|
|
|
Signals are emitted on the action group in response to state changes
|
|
on individual actions.
|
|
|
|
Implementations of #GActionGroup should provide implementations for
|
|
the virtual functions g_action_group_list_actions() and
|
|
g_action_group_query_action(). The other virtual functions should
|
|
not be implemented - their "wrappers" are actually implemented with
|
|
calls to g_action_group_query_action().</doc>
|
|
<source-position filename="gactiongroup.h" line="95"/>
|
|
<virtual-method name="action_added" invoker="action_added" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10312">Emits the #GActionGroup::action-added signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10314">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10315">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="action_enabled_changed" invoker="action_enabled_changed" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10325">Emits the #GActionGroup::action-enabled-changed signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10327">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10328">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10329">whether or not the action is now enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="action_removed" invoker="action_removed" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10339">Emits the #GActionGroup::action-removed signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10341">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10342">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="action_state_changed" invoker="action_state_changed" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10352">Emits the #GActionGroup::action-state-changed signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10354">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10355">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="state" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10356">the new state of the named action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="activate_action" invoker="activate_action" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10366">Activate the named action within @action_group.
|
|
|
|
If the action is expecting a parameter, then the correct type of
|
|
parameter must be given as @parameter. If the action is expecting no
|
|
parameters then @parameter must be %NULL. See
|
|
g_action_group_get_action_parameter_type().</doc>
|
|
<source-position filename="gactiongroup.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10368">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10369">the name of the action to activate</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10370">parameters to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="change_action_state" invoker="change_action_state" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10383">Request for the state of the named action within @action_group to be
|
|
changed to @value.
|
|
|
|
The action must be stateful and @value must be of the correct type.
|
|
See g_action_group_get_action_state_type().
|
|
|
|
This call merely requests a change. The action may refuse to change
|
|
its state or may change its state to something other than @value.
|
|
See g_action_group_get_action_state_hint().
|
|
|
|
If the @value GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gactiongroup.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10385">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10386">the name of the action to request the change on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10387">the new state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_action_enabled" invoker="get_action_enabled" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10405">Checks if the named action within @action_group is currently enabled.
|
|
|
|
An action must be enabled in order to be activated or in order to
|
|
have its state changed from outside callers.</doc>
|
|
<source-position filename="gactiongroup.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10415">whether or not the action is currently enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10407">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10408">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_action_parameter_type" invoker="get_action_parameter_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10420">Queries the type of the parameter that must be given when activating
|
|
the named action within @action_group.
|
|
|
|
When activating the action using g_action_group_activate_action(),
|
|
the #GVariant given to that function must be of the type returned
|
|
by this function.
|
|
|
|
In the case that this function returns %NULL, you must not give any
|
|
#GVariant, but %NULL instead.
|
|
|
|
The parameter type of a particular action will never change but it is
|
|
possible for an action to be removed and for a new action to be added
|
|
with the same name but a different parameter type.</doc>
|
|
<source-position filename="gactiongroup.h" line="55"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10439">the parameter type</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10422">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10423">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_action_state" invoker="get_action_state" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10444">Queries the current state of the named action within @action_group.
|
|
|
|
If the action is not stateful then %NULL will be returned. If the
|
|
action is stateful then the type of the return value is the type
|
|
given by g_action_group_get_action_state_type().
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gactiongroup.h" line="64"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10458">the current state of the action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10446">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10447">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_action_state_hint" invoker="get_action_state_hint" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10463">Requests a hint about the valid range of values for the state of the
|
|
named action within @action_group.
|
|
|
|
If %NULL is returned it either means that the action is not stateful
|
|
or that there is no hint about the valid range of values for the
|
|
state of the action.
|
|
|
|
If a #GVariant array is returned then each item in the array is a
|
|
possible value for the state. If a #GVariant pair (ie: two-tuple) is
|
|
returned then the tuple specifies the inclusive lower and upper bound
|
|
of valid values for the state.
|
|
|
|
In any case, the information is merely a hint. It may be possible to
|
|
have a state value outside of the hinted range and setting a value
|
|
within the range may fail.
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gactiongroup.h" line="61"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10487">the state range hint</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10465">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10466">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_action_state_type" invoker="get_action_state_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10492">Queries the type of the state of the named action within
|
|
@action_group.
|
|
|
|
If the action is stateful then this function returns the
|
|
#GVariantType of the state. All calls to
|
|
g_action_group_change_action_state() must give a #GVariant of this
|
|
type and g_action_group_get_action_state() will return a #GVariant
|
|
of the same type.
|
|
|
|
If the action is not stateful then this function will return %NULL.
|
|
In that case, g_action_group_get_action_state() will return %NULL
|
|
and you must not call g_action_group_change_action_state().
|
|
|
|
The state type of a particular action will never change but it is
|
|
possible for an action to be removed and for a new action to be added
|
|
with the same name but a different state type.</doc>
|
|
<source-position filename="gactiongroup.h" line="58"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10514">the state type, if the action is stateful</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10494">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10495">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="has_action" invoker="has_action" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10519">Checks if the named action exists within @action_group.</doc>
|
|
<source-position filename="gactiongroup.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10526">whether the named action exists</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10521">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10522">the name of the action to check for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="list_actions" invoker="list_actions" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10531">Lists the actions contained within @action_group.
|
|
|
|
The caller is responsible for freeing the list with g_strfreev() when
|
|
it is no longer required.</doc>
|
|
<source-position filename="gactiongroup.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10540">a %NULL-terminated array of the names of the
|
|
actions in the group</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10533">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_action" invoker="query_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10546">Queries all aspects of the named action within an @action_group.
|
|
|
|
This function acquires the information available from
|
|
g_action_group_has_action(), g_action_group_get_action_enabled(),
|
|
g_action_group_get_action_parameter_type(),
|
|
g_action_group_get_action_state_type(),
|
|
g_action_group_get_action_state_hint() and
|
|
g_action_group_get_action_state() with a single function call.
|
|
|
|
This provides two main benefits.
|
|
|
|
The first is the improvement in efficiency that comes with not having
|
|
to perform repeated lookups of the action in order to discover
|
|
different things about it. The second is that implementing
|
|
#GActionGroup can now be done by only overriding this one virtual
|
|
function.
|
|
|
|
The interface provides a default implementation of this function that
|
|
calls the individual functions, as required, to fetch the
|
|
information. The interface also provides default implementations of
|
|
those functions that call this function. All implementations,
|
|
therefore, must override either this function or all of the others.
|
|
|
|
If the action exists, %TRUE is returned and any of the requested
|
|
fields (as indicated by having a non-%NULL reference passed in) are
|
|
filled. If the action doesn't exist, %FALSE is returned and the
|
|
fields may or may not have been modified.</doc>
|
|
<source-position filename="gactiongroup.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10584">%TRUE if the action exists, else %FALSE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10548">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10549">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="enabled" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10550">if the action is presently enabled</doc>
|
|
<type name="gboolean" c:type="gboolean*"/>
|
|
</parameter>
|
|
<parameter name="parameter_type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10551">the parameter type, or %NULL if none needed</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType**"/>
|
|
</parameter>
|
|
<parameter name="state_type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10552">the state type, or %NULL if stateless</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType**"/>
|
|
</parameter>
|
|
<parameter name="state_hint" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10553">the state hint, or %NULL if none</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
<parameter name="state" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10554">the current state, or %NULL if stateless</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="action_added" c:identifier="g_action_group_action_added" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10312">Emits the #GActionGroup::action-added signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="135"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10314">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10315">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="action_enabled_changed" c:identifier="g_action_group_action_enabled_changed" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10325">Emits the #GActionGroup::action-enabled-changed signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="141"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10327">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10328">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10329">whether or not the action is now enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="action_removed" c:identifier="g_action_group_action_removed" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10339">Emits the #GActionGroup::action-removed signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10341">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10342">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="action_state_changed" c:identifier="g_action_group_action_state_changed" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10352">Emits the #GActionGroup::action-state-changed signal on @action_group.
|
|
|
|
This function should only be called by #GActionGroup implementations.</doc>
|
|
<source-position filename="gactiongroup.h" line="146"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10354">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10355">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="state" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10356">the new state of the named action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="activate_action" c:identifier="g_action_group_activate_action" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10366">Activate the named action within @action_group.
|
|
|
|
If the action is expecting a parameter, then the correct type of
|
|
parameter must be given as @parameter. If the action is expecting no
|
|
parameters then @parameter must be %NULL. See
|
|
g_action_group_get_action_parameter_type().</doc>
|
|
<source-position filename="gactiongroup.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10368">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10369">the name of the action to activate</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10370">parameters to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="change_action_state" c:identifier="g_action_group_change_action_state" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10383">Request for the state of the named action within @action_group to be
|
|
changed to @value.
|
|
|
|
The action must be stateful and @value must be of the correct type.
|
|
See g_action_group_get_action_state_type().
|
|
|
|
This call merely requests a change. The action may refuse to change
|
|
its state or may change its state to something other than @value.
|
|
See g_action_group_get_action_state_hint().
|
|
|
|
If the @value GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gactiongroup.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10385">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10386">the name of the action to request the change on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10387">the new state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_action_enabled" c:identifier="g_action_group_get_action_enabled" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10405">Checks if the named action within @action_group is currently enabled.
|
|
|
|
An action must be enabled in order to be activated or in order to
|
|
have its state changed from outside callers.</doc>
|
|
<source-position filename="gactiongroup.h" line="117"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10415">whether or not the action is currently enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10407">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10408">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_action_parameter_type" c:identifier="g_action_group_get_action_parameter_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10420">Queries the type of the parameter that must be given when activating
|
|
the named action within @action_group.
|
|
|
|
When activating the action using g_action_group_activate_action(),
|
|
the #GVariant given to that function must be of the type returned
|
|
by this function.
|
|
|
|
In the case that this function returns %NULL, you must not give any
|
|
#GVariant, but %NULL instead.
|
|
|
|
The parameter type of a particular action will never change but it is
|
|
possible for an action to be removed and for a new action to be added
|
|
with the same name but a different parameter type.</doc>
|
|
<source-position filename="gactiongroup.h" line="107"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10439">the parameter type</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10422">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10423">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_action_state" c:identifier="g_action_group_get_action_state" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10444">Queries the current state of the named action within @action_group.
|
|
|
|
If the action is not stateful then %NULL will be returned. If the
|
|
action is stateful then the type of the return value is the type
|
|
given by g_action_group_get_action_state_type().
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gactiongroup.h" line="121"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10458">the current state of the action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10446">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10447">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_action_state_hint" c:identifier="g_action_group_get_action_state_hint" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10463">Requests a hint about the valid range of values for the state of the
|
|
named action within @action_group.
|
|
|
|
If %NULL is returned it either means that the action is not stateful
|
|
or that there is no hint about the valid range of values for the
|
|
state of the action.
|
|
|
|
If a #GVariant array is returned then each item in the array is a
|
|
possible value for the state. If a #GVariant pair (ie: two-tuple) is
|
|
returned then the tuple specifies the inclusive lower and upper bound
|
|
of valid values for the state.
|
|
|
|
In any case, the information is merely a hint. It may be possible to
|
|
have a state value outside of the hinted range and setting a value
|
|
within the range may fail.
|
|
|
|
The return value (if non-%NULL) should be freed with
|
|
g_variant_unref() when it is no longer required.</doc>
|
|
<source-position filename="gactiongroup.h" line="113"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10487">the state range hint</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10465">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10466">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_action_state_type" c:identifier="g_action_group_get_action_state_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10492">Queries the type of the state of the named action within
|
|
@action_group.
|
|
|
|
If the action is stateful then this function returns the
|
|
#GVariantType of the state. All calls to
|
|
g_action_group_change_action_state() must give a #GVariant of this
|
|
type and g_action_group_get_action_state() will return a #GVariant
|
|
of the same type.
|
|
|
|
If the action is not stateful then this function will return %NULL.
|
|
In that case, g_action_group_get_action_state() will return %NULL
|
|
and you must not call g_action_group_change_action_state().
|
|
|
|
The state type of a particular action will never change but it is
|
|
possible for an action to be removed and for a new action to be added
|
|
with the same name but a different state type.</doc>
|
|
<source-position filename="gactiongroup.h" line="110"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10514">the state type, if the action is stateful</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10494">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10495">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_action" c:identifier="g_action_group_has_action" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10519">Checks if the named action exists within @action_group.</doc>
|
|
<source-position filename="gactiongroup.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10526">whether the named action exists</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10521">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10522">the name of the action to check for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="list_actions" c:identifier="g_action_group_list_actions" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10531">Lists the actions contained within @action_group.
|
|
|
|
The caller is responsible for freeing the list with g_strfreev() when
|
|
it is no longer required.</doc>
|
|
<source-position filename="gactiongroup.h" line="104"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10540">a %NULL-terminated array of the names of the
|
|
actions in the group</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10533">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_action" c:identifier="g_action_group_query_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10546">Queries all aspects of the named action within an @action_group.
|
|
|
|
This function acquires the information available from
|
|
g_action_group_has_action(), g_action_group_get_action_enabled(),
|
|
g_action_group_get_action_parameter_type(),
|
|
g_action_group_get_action_state_type(),
|
|
g_action_group_get_action_state_hint() and
|
|
g_action_group_get_action_state() with a single function call.
|
|
|
|
This provides two main benefits.
|
|
|
|
The first is the improvement in efficiency that comes with not having
|
|
to perform repeated lookups of the action in order to discover
|
|
different things about it. The second is that implementing
|
|
#GActionGroup can now be done by only overriding this one virtual
|
|
function.
|
|
|
|
The interface provides a default implementation of this function that
|
|
calls the individual functions, as required, to fetch the
|
|
information. The interface also provides default implementations of
|
|
those functions that call this function. All implementations,
|
|
therefore, must override either this function or all of the others.
|
|
|
|
If the action exists, %TRUE is returned and any of the requested
|
|
fields (as indicated by having a non-%NULL reference passed in) are
|
|
filled. If the action doesn't exist, %FALSE is returned and the
|
|
fields may or may not have been modified.</doc>
|
|
<source-position filename="gactiongroup.h" line="151"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10584">%TRUE if the action exists, else %FALSE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10548">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10549">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="enabled" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10550">if the action is presently enabled</doc>
|
|
<type name="gboolean" c:type="gboolean*"/>
|
|
</parameter>
|
|
<parameter name="parameter_type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10551">the parameter type, or %NULL if none needed</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType**"/>
|
|
</parameter>
|
|
<parameter name="state_type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10552">the state type, or %NULL if stateless</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType**"/>
|
|
</parameter>
|
|
<parameter name="state_hint" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10553">the state hint, or %NULL if none</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
<parameter name="state" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10554">the current state, or %NULL if stateless</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="action-added" when="last" detailed="1" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="108">Signals that a new action was just added to the group.
|
|
This signal is emitted after the action has been added
|
|
and is now visible.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="111">the name of the action in @action_group</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="action-enabled-changed" when="last" detailed="1" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="121">Signals that the enabled status of the named action has changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="124">the name of the action in @action_group</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="125">whether the action is enabled or not</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="action-removed" when="last" detailed="1" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="133">Signals that an action is just about to be removed from the group.
|
|
This signal is emitted before the action is removed, so the action
|
|
is still visible and can be queried from the signal handler.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="136">the name of the action in @action_group</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="action-state-changed" when="last" detailed="1" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="146">Signals that the state of the named action has changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="149">the name of the action in @action_group</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="150">the new value of the state</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="ActionGroupInterface" c:type="GActionGroupInterface" glib:is-gtype-struct-for="ActionGroup" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="158">The virtual function table for #GActionGroup.</doc>
|
|
<source-position filename="gactiongroup.h" line="95"/>
|
|
<field name="g_iface">
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="has_action">
|
|
<callback name="has_action">
|
|
<source-position filename="gactiongroup.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10526">whether the named action exists</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10521">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10522">the name of the action to check for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="list_actions">
|
|
<callback name="list_actions">
|
|
<source-position filename="gactiongroup.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10540">a %NULL-terminated array of the names of the
|
|
actions in the group</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10533">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_action_enabled">
|
|
<callback name="get_action_enabled">
|
|
<source-position filename="gactiongroup.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10415">whether or not the action is currently enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10407">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10408">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_action_parameter_type">
|
|
<callback name="get_action_parameter_type">
|
|
<source-position filename="gactiongroup.h" line="55"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10439">the parameter type</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10422">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10423">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_action_state_type">
|
|
<callback name="get_action_state_type">
|
|
<source-position filename="gactiongroup.h" line="58"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10514">the state type, if the action is stateful</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10494">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10495">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_action_state_hint">
|
|
<callback name="get_action_state_hint">
|
|
<source-position filename="gactiongroup.h" line="61"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10487">the state range hint</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10465">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10466">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_action_state">
|
|
<callback name="get_action_state">
|
|
<source-position filename="gactiongroup.h" line="64"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10458">the current state of the action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10446">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10447">the name of the action to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="change_action_state">
|
|
<callback name="change_action_state">
|
|
<source-position filename="gactiongroup.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10385">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10386">the name of the action to request the change on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10387">the new state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="activate_action">
|
|
<callback name="activate_action">
|
|
<source-position filename="gactiongroup.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10368">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10369">the name of the action to activate</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10370">parameters to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="action_added">
|
|
<callback name="action_added">
|
|
<source-position filename="gactiongroup.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10314">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10315">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="action_removed">
|
|
<callback name="action_removed">
|
|
<source-position filename="gactiongroup.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10341">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10342">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="action_enabled_changed">
|
|
<callback name="action_enabled_changed">
|
|
<source-position filename="gactiongroup.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10327">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10328">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10329">whether or not the action is now enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="action_state_changed">
|
|
<callback name="action_state_changed">
|
|
<source-position filename="gactiongroup.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10354">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10355">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="state" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10356">the new state of the named action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_action">
|
|
<callback name="query_action">
|
|
<source-position filename="gactiongroup.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10584">%TRUE if the action exists, else %FALSE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10548">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10549">the name of an action in the group</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="enabled" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10550">if the action is presently enabled</doc>
|
|
<type name="gboolean" c:type="gboolean*"/>
|
|
</parameter>
|
|
<parameter name="parameter_type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10551">the parameter type, or %NULL if none needed</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType**"/>
|
|
</parameter>
|
|
<parameter name="state_type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10552">the state type, or %NULL if stateless</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType**"/>
|
|
</parameter>
|
|
<parameter name="state_hint" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10553">the state hint, or %NULL if none</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
<parameter name="state" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10554">the current state, or %NULL if stateless</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="ActionInterface" c:type="GActionInterface" glib:is-gtype-struct-for="Action" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="181">The virtual function table for #GAction.</doc>
|
|
<source-position filename="gaction.h" line="57"/>
|
|
<field name="g_iface">
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_name">
|
|
<callback name="get_name">
|
|
<source-position filename="gaction.h" line="45"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10221">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10217">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_parameter_type">
|
|
<callback name="get_parameter_type">
|
|
<source-position filename="gaction.h" line="46"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10239">the parameter type</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10228">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_state_type">
|
|
<callback name="get_state_type">
|
|
<source-position filename="gaction.h" line="47"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10307">the state type, if the action is stateful</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10292">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_state_hint">
|
|
<callback name="get_state_hint">
|
|
<source-position filename="gaction.h" line="48"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10285">the state range hint</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10264">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_enabled">
|
|
<callback name="get_enabled">
|
|
<source-position filename="gaction.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10210">whether the action is enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10203">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_state">
|
|
<callback name="get_state">
|
|
<source-position filename="gaction.h" line="51"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10257">the current state of the action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10246">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="change_state">
|
|
<callback name="change_state">
|
|
<source-position filename="gaction.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10183">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10184">the new state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="activate">
|
|
<callback name="activate">
|
|
<source-position filename="gaction.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10166">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10167">the parameter to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<interface name="ActionMap" c:symbol-prefix="action_map" c:type="GActionMap" version="2.32" glib:type-name="GActionMap" glib:get-type="g_action_map_get_type" glib:type-struct="ActionMapInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4575">The GActionMap interface is implemented by #GActionGroup
|
|
implementations that operate by containing a number of
|
|
named #GAction instances, such as #GSimpleActionGroup.
|
|
|
|
One useful application of this interface is to map the
|
|
names of actions from various action groups to unique,
|
|
prefixed names (e.g. by prepending "app." or "win.").
|
|
This is the motivation for the 'Map' part of the interface
|
|
name.</doc>
|
|
<source-position filename="gactionmap.h" line="53"/>
|
|
<virtual-method name="add_action" invoker="add_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10589">Adds an action to the @action_map.
|
|
|
|
If the action map already contains an action with the same name
|
|
as @action then the old action is dropped from the action map.
|
|
|
|
The action map takes its own reference on @action.</doc>
|
|
<source-position filename="gactionmap.h" line="49"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10591">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</instance-parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10592">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_action" invoker="lookup_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10655">Looks up the action with the name @action_name in @action_map.
|
|
|
|
If no such action exists, returns %NULL.</doc>
|
|
<source-position filename="gactionmap.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10664">a #GAction, or %NULL</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10657">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10658">the name of an action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="remove_action" invoker="remove_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10669">Removes the named action from the action map.
|
|
|
|
If no action of this name is in the map then nothing happens.</doc>
|
|
<source-position filename="gactionmap.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10671">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10672">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="add_action" c:identifier="g_action_map_add_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10589">Adds an action to the @action_map.
|
|
|
|
If the action map already contains an action with the same name
|
|
as @action then the old action is dropped from the action map.
|
|
|
|
The action map takes its own reference on @action.</doc>
|
|
<source-position filename="gactionmap.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10591">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</instance-parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10592">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_action_entries" c:identifier="g_action_map_add_action_entries" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10605">A convenience function for creating multiple #GSimpleAction instances
|
|
and adding them to a #GActionMap.
|
|
|
|
Each action is constructed as per one #GActionEntry.
|
|
|
|
|[<!-- language="C" -->
|
|
static void
|
|
activate_quit (GSimpleAction *simple,
|
|
GVariant *parameter,
|
|
gpointer user_data)
|
|
{
|
|
exit (0);
|
|
}
|
|
|
|
static void
|
|
activate_print_string (GSimpleAction *simple,
|
|
GVariant *parameter,
|
|
gpointer user_data)
|
|
{
|
|
g_print ("%s\n", g_variant_get_string (parameter, NULL));
|
|
}
|
|
|
|
static GActionGroup *
|
|
create_action_group (void)
|
|
{
|
|
const GActionEntry entries[] = {
|
|
{ "quit", activate_quit },
|
|
{ "print-string", activate_print_string, "s" }
|
|
};
|
|
GSimpleActionGroup *group;
|
|
|
|
group = g_simple_action_group_new ();
|
|
g_action_map_add_action_entries (G_ACTION_MAP (group), entries, G_N_ELEMENTS (entries), NULL);
|
|
|
|
return G_ACTION_GROUP (group);
|
|
}
|
|
]|</doc>
|
|
<source-position filename="gactionmap.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10607">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</instance-parameter>
|
|
<parameter name="entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10608">a pointer to
|
|
the first item in an array of #GActionEntry structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GActionEntry*">
|
|
<type name="ActionEntry"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10610">the length of @entries, or -1 if @entries is %NULL-terminated</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10611">the user data for signal connections</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_action" c:identifier="g_action_map_lookup_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10655">Looks up the action with the name @action_name in @action_map.
|
|
|
|
If no such action exists, returns %NULL.</doc>
|
|
<source-position filename="gactionmap.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10664">a #GAction, or %NULL</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10657">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10658">the name of an action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_action" c:identifier="g_action_map_remove_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10669">Removes the named action from the action map.
|
|
|
|
If no action of this name is in the map then nothing happens.</doc>
|
|
<source-position filename="gactionmap.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10671">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10672">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="ActionMapInterface" c:type="GActionMapInterface" glib:is-gtype-struct-for="ActionMap" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="207">The virtual function table for #GActionMap.</doc>
|
|
<source-position filename="gactionmap.h" line="53"/>
|
|
<field name="g_iface">
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="lookup_action">
|
|
<callback name="lookup_action">
|
|
<source-position filename="gactionmap.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10664">a #GAction, or %NULL</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10657">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10658">the name of an action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="add_action">
|
|
<callback name="add_action">
|
|
<source-position filename="gactionmap.h" line="49"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10591">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10592">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="remove_action">
|
|
<callback name="remove_action">
|
|
<source-position filename="gactionmap.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_map" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10671">a #GActionMap</doc>
|
|
<type name="ActionMap" c:type="GActionMap*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10672">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<interface name="AppInfo" c:symbol-prefix="app_info" c:type="GAppInfo" glib:type-name="GAppInfo" glib:get-type="g_app_info_get_type" glib:type-struct="AppInfoIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4595">#GAppInfo and #GAppLaunchContext are used for describing and launching
|
|
applications installed on the system.
|
|
|
|
As of GLib 2.20, URIs will always be converted to POSIX paths
|
|
(using g_file_get_path()) when using g_app_info_launch() even if
|
|
the application requested an URI and not a POSIX path. For example
|
|
for an desktop-file based application with Exec key `totem
|
|
%U` and a single URI, `sftp://foo/file.avi`, then
|
|
`/home/user/.gvfs/sftp on foo/file.avi` will be passed. This will
|
|
only work if a set of suitable GIO extensions (such as gvfs 2.26
|
|
compiled with FUSE support), is available and operational; if this
|
|
is not the case, the URI will be passed unmodified to the application.
|
|
Some URIs, such as `mailto:`, of course cannot be mapped to a POSIX
|
|
path (in gvfs there's no FUSE mount for it); such URIs will be
|
|
passed unmodified to the application.
|
|
|
|
Specifically for gvfs 2.26 and later, the POSIX URI will be mapped
|
|
back to the GIO URI in the #GFile constructors (since gvfs
|
|
implements the #GVfs extension point). As such, if the application
|
|
needs to examine the URI, it needs to use g_file_get_uri() or
|
|
similar on #GFile. In other words, an application cannot assume
|
|
that the URI passed to e.g. g_file_new_for_commandline_arg() is
|
|
equal to the result of g_file_get_uri(). The following snippet
|
|
illustrates this:
|
|
|
|
|[
|
|
GFile *f;
|
|
char *uri;
|
|
|
|
file = g_file_new_for_commandline_arg (uri_from_commandline);
|
|
|
|
uri = g_file_get_uri (file);
|
|
strcmp (uri, uri_from_commandline) == 0;
|
|
g_free (uri);
|
|
|
|
if (g_file_has_uri_scheme (file, "cdda"))
|
|
{
|
|
// do something special with uri
|
|
}
|
|
g_object_unref (file);
|
|
]|
|
|
|
|
This code will work when both `cdda://sr0/Track 1.wav` and
|
|
`/home/user/.gvfs/cdda on sr0/Track 1.wav` is passed to the
|
|
application. It should be noted that it's generally not safe
|
|
for applications to rely on the format of a particular URIs.
|
|
Different launcher applications (e.g. file managers) may have
|
|
different ideas of what a given URI means.</doc>
|
|
<source-position filename="gappinfo.h" line="145"/>
|
|
<function name="create_from_commandline" c:identifier="g_app_info_create_from_commandline" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10793">Creates a new #GAppInfo from the given information.
|
|
|
|
Note that for @commandline, the quoting rules of the Exec key of the
|
|
[freedesktop.org Desktop Entry Specification](http://freedesktop.org/Standards/desktop-entry-spec)
|
|
are applied. For example, if the @commandline contains
|
|
percent-encoded URIs, the percent-character must be doubled in order to prevent it from
|
|
being swallowed by Exec key unquoting. See the specification for exact quoting rules.</doc>
|
|
<source-position filename="gappinfo.h" line="150"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10808">new #GAppInfo for given command.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="commandline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10795">the commandline to use</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="application_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10796">the application name, or %NULL to use @commandline</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10797">flags that can specify details of the created #GAppInfo</doc>
|
|
<type name="AppInfoCreateFlags" c:type="GAppInfoCreateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_all" c:identifier="g_app_info_get_all">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10852">Gets a list of all of the applications currently registered
|
|
on this system.
|
|
|
|
For desktop files, this includes applications that have
|
|
`NoDisplay=true` set or are excluded from display by means
|
|
of `OnlyShowIn` or `NotShowIn`. See g_app_info_should_show().
|
|
The returned list does not include applications which have
|
|
the `Hidden` key set.</doc>
|
|
<source-position filename="gappinfo.h" line="234"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10864">a newly allocated #GList of references to #GAppInfos.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
</function>
|
|
<function name="get_all_for_type" c:identifier="g_app_info_get_all_for_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10868">Gets a list of all #GAppInfos for a given content type,
|
|
including the recommended and fallback #GAppInfos. See
|
|
g_app_info_get_recommended_for_type() and
|
|
g_app_info_get_fallback_for_type().</doc>
|
|
<source-position filename="gappinfo.h" line="236"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10877">#GList of #GAppInfos
|
|
for given @content_type or %NULL on error.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10870">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_default_for_type" c:identifier="g_app_info_get_default_for_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10895">Gets the default #GAppInfo for a given content type.</doc>
|
|
<source-position filename="gappinfo.h" line="245"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10903">#GAppInfo for given @content_type or
|
|
%NULL on error.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10897">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="must_support_uris" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10898">if %TRUE, the #GAppInfo is expected to
|
|
support URIs</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_default_for_uri_scheme" c:identifier="g_app_info_get_default_for_uri_scheme">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10908">Gets the default application for handling URIs with
|
|
the given URI scheme. A URI scheme is the initial part
|
|
of the URI, up to but not including the ':', e.g. "http",
|
|
"ftp" or "sip".</doc>
|
|
<source-position filename="gappinfo.h" line="248"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10917">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10910">a string containing a URI scheme.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_fallback_for_type" c:identifier="g_app_info_get_fallback_for_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10956">Gets a list of fallback #GAppInfos for a given content type, i.e.
|
|
those applications which claim to support the given content type
|
|
by MIME type subclassing and not directly.</doc>
|
|
<source-position filename="gappinfo.h" line="240"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10964">#GList of #GAppInfos
|
|
for given @content_type or %NULL on error.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10958">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_recommended_for_type" c:identifier="g_app_info_get_recommended_for_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11007">Gets a list of recommended #GAppInfos for a given content type, i.e.
|
|
those applications which claim to support the given content type exactly,
|
|
and not by MIME type subclassing.
|
|
Note that the first application of the list is the last used one, i.e.
|
|
the last one for which g_app_info_set_as_last_used_for_type() has been
|
|
called.</doc>
|
|
<source-position filename="gappinfo.h" line="238"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11018">#GList of #GAppInfos
|
|
for given @content_type or %NULL on error.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11009">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="launch_default_for_uri" c:identifier="g_app_info_launch_default_for_uri" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11080">Utility function that launches the default application
|
|
registered to handle the specified uri. Synchronous I/O
|
|
is done on the uri to detect the type of the file if
|
|
required.
|
|
|
|
The D-Bus–activated applications don't have to be started if your application
|
|
terminates too soon after this function. To prevent this, use
|
|
g_app_info_launch_default_for_uri_async() instead.</doc>
|
|
<source-position filename="gappinfo.h" line="251"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11095">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11082">the uri to show</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11083">an optional #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="launch_default_for_uri_async" c:identifier="g_app_info_launch_default_for_uri_async" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11099">Async version of g_app_info_launch_default_for_uri().
|
|
|
|
This version is useful if you are interested in receiving
|
|
error information in the case where the application is
|
|
sandboxed and the portal may present an application chooser
|
|
dialog to the user.
|
|
|
|
This is also useful if you want to be sure that the D-Bus–activated
|
|
applications are really started before termination and if you are interested
|
|
in receiving error information from their activation.</doc>
|
|
<source-position filename="gappinfo.h" line="256"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11101">the uri to show</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11102">an optional #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11103">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11104">a #GAsyncReadyCallback to call when the request is done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11105">data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="launch_default_for_uri_finish" c:identifier="g_app_info_launch_default_for_uri_finish" version="2.50" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11122">Finishes an asynchronous launch-default-for-uri operation.</doc>
|
|
<source-position filename="gappinfo.h" line="262"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11129">%TRUE if the launch was successful, %FALSE if @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11124">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="reset_type_associations" c:identifier="g_app_info_reset_type_associations" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11219">Removes all changes to the type associations done by
|
|
g_app_info_set_as_default_for_type(),
|
|
g_app_info_set_as_default_for_extension(),
|
|
g_app_info_add_supports_type() or
|
|
g_app_info_remove_supports_type().</doc>
|
|
<source-position filename="gappinfo.h" line="243"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11221">a content type</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="add_supports_type" invoker="add_supports_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10757">Adds a content type to the application information to indicate the
|
|
application is capable of opening files with the given content type.</doc>
|
|
<source-position filename="gappinfo.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10766">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10759">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10760">a string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_delete" invoker="can_delete" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10770">Obtains the information whether the #GAppInfo can be deleted.
|
|
See g_app_info_delete().</doc>
|
|
<source-position filename="gappinfo.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10777">%TRUE if @appinfo can be deleted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10772">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_remove_supports_type" invoker="can_remove_supports_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10782">Checks if a supported content type can be removed from an application.</doc>
|
|
<source-position filename="gappinfo.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10788">%TRUE if it is possible to remove supported
|
|
content types from a given @appinfo, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10784">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="do_delete" invoker="delete" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10812">Tries to delete a #GAppInfo.
|
|
|
|
On some platforms, there may be a difference between user-defined
|
|
#GAppInfos which can be deleted, and system-wide ones which cannot.
|
|
See g_app_info_can_delete().</doc>
|
|
<source-position filename="gappinfo.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10822">%TRUE if @appinfo has been deleted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10814">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="dup" invoker="dup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10827">Creates a duplicate of a #GAppInfo.</doc>
|
|
<source-position filename="gappinfo.h" line="94"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10833">a duplicate of @appinfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10829">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="equal" invoker="equal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10837">Checks if two #GAppInfos are equal.
|
|
|
|
Note that the check <emphasis>may not</emphasis> compare each individual
|
|
field, and only does an identity check. In case detecting changes in the
|
|
contents is needed, program code must additionally compare relevant fields.</doc>
|
|
<source-position filename="gappinfo.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10848">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10839">the first #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="appinfo2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10840">the second #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_commandline">
|
|
<source-position filename="gappinfo.h" line="130"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_description" invoker="get_description">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10921">Gets a human-readable description of an installed application.</doc>
|
|
<source-position filename="gappinfo.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10927">a string containing a description of the
|
|
application @appinfo, or %NULL if none.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10923">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_display_name" invoker="get_display_name" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10932">Gets the display name of the application. The display name is often more
|
|
descriptive to the user than the name itself.</doc>
|
|
<source-position filename="gappinfo.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10939">the display name of the application for @appinfo, or the name if
|
|
no display name is available.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10934">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_executable">
|
|
<source-position filename="gappinfo.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_icon" invoker="get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10970">Gets the icon for the application.</doc>
|
|
<source-position filename="gappinfo.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10976">the default #GIcon for @appinfo or %NULL
|
|
if there is no default icon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10972">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_id" invoker="get_id">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10981">Gets the ID of an application. An id is a string that
|
|
identifies the application. The exact format of the id is
|
|
platform dependent. For instance, on Unix this is the
|
|
desktop file id from the xdg menu specification.
|
|
|
|
Note that the returned ID may be %NULL, depending on how
|
|
the @appinfo has been constructed.</doc>
|
|
<source-position filename="gappinfo.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10993">a string containing the application's ID.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10983">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_name" invoker="get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10997">Gets the installed name of the application.</doc>
|
|
<source-position filename="gappinfo.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11003">the name of the application for @appinfo.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10999">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_supported_types" invoker="get_supported_types" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11024">Retrieves the list of content types that @app_info claims to support.
|
|
If this information is not provided by the environment, this function
|
|
will return %NULL.
|
|
This function does not take in consideration associations added with
|
|
g_app_info_add_supports_type(), but only those exported directly by
|
|
the application.</doc>
|
|
<source-position filename="gappinfo.h" line="135"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11035">
|
|
a list of content types.</doc>
|
|
<array c:type="const char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11026">a #GAppInfo that can handle files</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="launch" invoker="launch" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11041">Launches the application. Passes @files to the launched application
|
|
as arguments, using the optional @context to get information
|
|
about the details of the launcher (like what screen it is on).
|
|
On error, @error will be set accordingly.
|
|
|
|
To launch the application without arguments pass a %NULL @files list.
|
|
|
|
Note that even if the launch is successful the application launched
|
|
can fail to start if it runs into problems during startup. There is
|
|
no way to detect this.
|
|
|
|
Some URIs can be changed when passed through a GFile (for instance
|
|
unsupported URIs with strange formats like mailto:), so if you have
|
|
a textual URI you want to pass in as argument, consider using
|
|
g_app_info_launch_uris() instead.
|
|
|
|
The launched application inherits the environment of the launching
|
|
process, but it can be modified with g_app_launch_context_setenv()
|
|
and g_app_launch_context_unsetenv().
|
|
|
|
On UNIX, this function sets the `GIO_LAUNCHED_DESKTOP_FILE`
|
|
environment variable with the path of the launched desktop file and
|
|
`GIO_LAUNCHED_DESKTOP_FILE_PID` to the process id of the launched
|
|
process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`,
|
|
should it be inherited by further processes. The `DISPLAY` and
|
|
`DESKTOP_STARTUP_ID` environment variables are also set, based
|
|
on information provided in @context.</doc>
|
|
<source-position filename="gappinfo.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11076">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11043">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="files" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11044">a #GList of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11045">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="launch_uris" invoker="launch_uris" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11134">Launches the application. This passes the @uris to the launched application
|
|
as arguments, using the optional @context to get information
|
|
about the details of the launcher (like what screen it is on).
|
|
On error, @error will be set accordingly.
|
|
|
|
To launch the application without arguments pass a %NULL @uris list.
|
|
|
|
Note that even if the launch is successful the application launched
|
|
can fail to start if it runs into problems during startup. There is
|
|
no way to detect this.</doc>
|
|
<source-position filename="gappinfo.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11152">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11136">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="uris" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11137">a #GList containing URIs to launch.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11138">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="launch_uris_async" invoker="launch_uris_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11156">Async version of g_app_info_launch_uris().
|
|
|
|
The @callback is invoked immediately after the application launch, but it
|
|
waits for activation in case of D-Bus–activated applications and also provides
|
|
extended error information for sandboxed applications, see notes for
|
|
g_app_info_launch_default_for_uri_async().</doc>
|
|
<source-position filename="gappinfo.h" line="136"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11158">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="uris" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11159">a #GList containing URIs to launch.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11160">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11161">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11162">a #GAsyncReadyCallback to call when the request is done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11163">data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="launch_uris_finish" invoker="launch_uris_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11176">Finishes a g_app_info_launch_uris_async() operation.</doc>
|
|
<source-position filename="gappinfo.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11184">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11178">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11179">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="remove_supports_type" invoker="remove_supports_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11207">Removes a supported type from an application, if possible.</doc>
|
|
<source-position filename="gappinfo.h" line="125"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11215">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11209">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11210">a string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_as_default_for_extension" invoker="set_as_default_for_extension" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11233">Sets the application as the default handler for the given file extension.</doc>
|
|
<source-position filename="gappinfo.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11242">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11235">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11236">a string containing the file extension
|
|
(without the dot).</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_as_default_for_type" invoker="set_as_default_for_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11246">Sets the application as the default handler for a given type.</doc>
|
|
<source-position filename="gappinfo.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11254">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11248">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11249">the content type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_as_last_used_for_type" invoker="set_as_last_used_for_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11258">Sets the application as the last used application for a given type.
|
|
This will make the application appear as first in the list returned
|
|
by g_app_info_get_recommended_for_type(), regardless of the default
|
|
application for that content type.</doc>
|
|
<source-position filename="gappinfo.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11269">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11260">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11261">the content type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="should_show" invoker="should_show">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11273">Checks if the application info should be shown in menus that
|
|
list available applications.</doc>
|
|
<source-position filename="gappinfo.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11280">%TRUE if the @appinfo should be shown, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11275">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="supports_files" invoker="supports_files">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11284">Checks if the application accepts files as arguments.</doc>
|
|
<source-position filename="gappinfo.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11290">%TRUE if the @appinfo supports files.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11286">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="supports_uris" invoker="supports_uris">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11294">Checks if the application supports reading files and directories from URIs.</doc>
|
|
<source-position filename="gappinfo.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11300">%TRUE if the @appinfo supports URIs.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11296">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="add_supports_type" c:identifier="g_app_info_add_supports_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10757">Adds a content type to the application information to indicate the
|
|
application is capable of opening files with the given content type.</doc>
|
|
<source-position filename="gappinfo.h" line="211"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10766">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10759">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10760">a string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_delete" c:identifier="g_app_info_can_delete" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10770">Obtains the information whether the #GAppInfo can be deleted.
|
|
See g_app_info_delete().</doc>
|
|
<source-position filename="gappinfo.h" line="224"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10777">%TRUE if @appinfo can be deleted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10772">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_remove_supports_type" c:identifier="g_app_info_can_remove_supports_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10782">Checks if a supported content type can be removed from an application.</doc>
|
|
<source-position filename="gappinfo.h" line="215"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10788">%TRUE if it is possible to remove supported
|
|
content types from a given @appinfo, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10784">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="delete" c:identifier="g_app_info_delete" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10812">Tries to delete a #GAppInfo.
|
|
|
|
On some platforms, there may be a difference between user-defined
|
|
#GAppInfos which can be deleted, and system-wide ones which cannot.
|
|
See g_app_info_can_delete().</doc>
|
|
<source-position filename="gappinfo.h" line="226"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10822">%TRUE if @appinfo has been deleted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10814">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dup" c:identifier="g_app_info_dup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10827">Creates a duplicate of a #GAppInfo.</doc>
|
|
<source-position filename="gappinfo.h" line="155"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10833">a duplicate of @appinfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10829">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="equal" c:identifier="g_app_info_equal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10837">Checks if two #GAppInfos are equal.
|
|
|
|
Note that the check <emphasis>may not</emphasis> compare each individual
|
|
field, and only does an identity check. In case detecting changes in the
|
|
contents is needed, program code must additionally compare relevant fields.</doc>
|
|
<source-position filename="gappinfo.h" line="157"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10848">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10839">the first #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="appinfo2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10840">the second #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_commandline" c:identifier="g_app_info_get_commandline" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10882">Gets the commandline with which the application will be
|
|
started.</doc>
|
|
<source-position filename="gappinfo.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10889">a string containing the @appinfo's commandline,
|
|
or %NULL if this information is not available</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10884">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_description" c:identifier="g_app_info_get_description">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10921">Gets a human-readable description of an installed application.</doc>
|
|
<source-position filename="gappinfo.h" line="166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10927">a string containing a description of the
|
|
application @appinfo, or %NULL if none.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10923">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_display_name" c:identifier="g_app_info_get_display_name" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10932">Gets the display name of the application. The display name is often more
|
|
descriptive to the user than the name itself.</doc>
|
|
<source-position filename="gappinfo.h" line="164"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10939">the display name of the application for @appinfo, or the name if
|
|
no display name is available.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10934">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_executable" c:identifier="g_app_info_get_executable">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10945">Gets the executable's name for the installed application.</doc>
|
|
<source-position filename="gappinfo.h" line="168"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10951">a string containing the @appinfo's application
|
|
binaries name</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10947">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_icon" c:identifier="g_app_info_get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10970">Gets the icon for the application.</doc>
|
|
<source-position filename="gappinfo.h" line="172"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10976">the default #GIcon for @appinfo or %NULL
|
|
if there is no default icon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10972">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_id" c:identifier="g_app_info_get_id">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10981">Gets the ID of an application. An id is a string that
|
|
identifies the application. The exact format of the id is
|
|
platform dependent. For instance, on Unix this is the
|
|
desktop file id from the xdg menu specification.
|
|
|
|
Note that the returned ID may be %NULL, depending on how
|
|
the @appinfo has been constructed.</doc>
|
|
<source-position filename="gappinfo.h" line="160"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10993">a string containing the application's ID.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10983">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_app_info_get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10997">Gets the installed name of the application.</doc>
|
|
<source-position filename="gappinfo.h" line="162"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11003">the name of the application for @appinfo.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10999">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_supported_types" c:identifier="g_app_info_get_supported_types" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11024">Retrieves the list of content types that @app_info claims to support.
|
|
If this information is not provided by the environment, this function
|
|
will return %NULL.
|
|
This function does not take in consideration associations added with
|
|
g_app_info_add_supports_type(), but only those exported directly by
|
|
the application.</doc>
|
|
<source-position filename="gappinfo.h" line="221"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11035">
|
|
a list of content types.</doc>
|
|
<array c:type="const char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11026">a #GAppInfo that can handle files</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch" c:identifier="g_app_info_launch" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11041">Launches the application. Passes @files to the launched application
|
|
as arguments, using the optional @context to get information
|
|
about the details of the launcher (like what screen it is on).
|
|
On error, @error will be set accordingly.
|
|
|
|
To launch the application without arguments pass a %NULL @files list.
|
|
|
|
Note that even if the launch is successful the application launched
|
|
can fail to start if it runs into problems during startup. There is
|
|
no way to detect this.
|
|
|
|
Some URIs can be changed when passed through a GFile (for instance
|
|
unsupported URIs with strange formats like mailto:), so if you have
|
|
a textual URI you want to pass in as argument, consider using
|
|
g_app_info_launch_uris() instead.
|
|
|
|
The launched application inherits the environment of the launching
|
|
process, but it can be modified with g_app_launch_context_setenv()
|
|
and g_app_launch_context_unsetenv().
|
|
|
|
On UNIX, this function sets the `GIO_LAUNCHED_DESKTOP_FILE`
|
|
environment variable with the path of the launched desktop file and
|
|
`GIO_LAUNCHED_DESKTOP_FILE_PID` to the process id of the launched
|
|
process. This can be used to ignore `GIO_LAUNCHED_DESKTOP_FILE`,
|
|
should it be inherited by further processes. The `DISPLAY` and
|
|
`DESKTOP_STARTUP_ID` environment variables are also set, based
|
|
on information provided in @context.</doc>
|
|
<source-position filename="gappinfo.h" line="174"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11076">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11043">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="files" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11044">a #GList of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11045">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch_uris" c:identifier="g_app_info_launch_uris" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11134">Launches the application. This passes the @uris to the launched application
|
|
as arguments, using the optional @context to get information
|
|
about the details of the launcher (like what screen it is on).
|
|
On error, @error will be set accordingly.
|
|
|
|
To launch the application without arguments pass a %NULL @uris list.
|
|
|
|
Note that even if the launch is successful the application launched
|
|
can fail to start if it runs into problems during startup. There is
|
|
no way to detect this.</doc>
|
|
<source-position filename="gappinfo.h" line="183"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11152">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11136">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="uris" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11137">a #GList containing URIs to launch.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11138">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch_uris_async" c:identifier="g_app_info_launch_uris_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11156">Async version of g_app_info_launch_uris().
|
|
|
|
The @callback is invoked immediately after the application launch, but it
|
|
waits for activation in case of D-Bus–activated applications and also provides
|
|
extended error information for sandboxed applications, see notes for
|
|
g_app_info_launch_default_for_uri_async().</doc>
|
|
<source-position filename="gappinfo.h" line="188"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11158">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="uris" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11159">a #GList containing URIs to launch.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11160">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11161">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11162">a #GAsyncReadyCallback to call when the request is done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11163">data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch_uris_finish" c:identifier="g_app_info_launch_uris_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11176">Finishes a g_app_info_launch_uris_async() operation.</doc>
|
|
<source-position filename="gappinfo.h" line="195"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11184">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11178">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11179">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_supports_type" c:identifier="g_app_info_remove_supports_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11207">Removes a supported type from an application, if possible.</doc>
|
|
<source-position filename="gappinfo.h" line="217"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11215">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11209">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11210">a string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_as_default_for_extension" c:identifier="g_app_info_set_as_default_for_extension" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11233">Sets the application as the default handler for the given file extension.</doc>
|
|
<source-position filename="gappinfo.h" line="207"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11242">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11235">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11236">a string containing the file extension
|
|
(without the dot).</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_as_default_for_type" c:identifier="g_app_info_set_as_default_for_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11246">Sets the application as the default handler for a given type.</doc>
|
|
<source-position filename="gappinfo.h" line="203"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11254">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11248">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11249">the content type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_as_last_used_for_type" c:identifier="g_app_info_set_as_last_used_for_type" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11258">Sets the application as the last used application for a given type.
|
|
This will make the application appear as first in the list returned
|
|
by g_app_info_get_recommended_for_type(), regardless of the default
|
|
application for that content type.</doc>
|
|
<source-position filename="gappinfo.h" line="229"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11269">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11260">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11261">the content type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="should_show" c:identifier="g_app_info_should_show">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11273">Checks if the application info should be shown in menus that
|
|
list available applications.</doc>
|
|
<source-position filename="gappinfo.h" line="200"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11280">%TRUE if the @appinfo should be shown, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11275">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="supports_files" c:identifier="g_app_info_supports_files">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11284">Checks if the application accepts files as arguments.</doc>
|
|
<source-position filename="gappinfo.h" line="181"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11290">%TRUE if the @appinfo supports files.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11286">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="supports_uris" c:identifier="g_app_info_supports_uris">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11294">Checks if the application supports reading files and directories from URIs.</doc>
|
|
<source-position filename="gappinfo.h" line="179"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11300">%TRUE if the @appinfo supports URIs.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11296">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<bitfield name="AppInfoCreateFlags" glib:type-name="GAppInfoCreateFlags" glib:get-type="g_app_info_create_flags_get_type" c:type="GAppInfoCreateFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="33">Flags used when creating a #GAppInfo.</doc>
|
|
<member name="none" value="0" c:identifier="G_APP_INFO_CREATE_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="35">No flags.</doc>
|
|
</member>
|
|
<member name="needs_terminal" value="1" c:identifier="G_APP_INFO_CREATE_NEEDS_TERMINAL" glib:nick="needs-terminal">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="36">Application opens in a terminal window.</doc>
|
|
</member>
|
|
<member name="supports_uris" value="2" c:identifier="G_APP_INFO_CREATE_SUPPORTS_URIS" glib:nick="supports-uris">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="37">Application supports URI arguments.</doc>
|
|
</member>
|
|
<member name="supports_startup_notification" value="4" c:identifier="G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION" glib:nick="supports-startup-notification">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="38">Application supports startup notification. Since 2.26</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="AppInfoIface" c:type="GAppInfoIface" glib:is-gtype-struct-for="AppInfo">
|
|
<doc xml:space="preserve" filename="gappinfo.h" line="54">Application Information interface, for operating system portability.</doc>
|
|
<source-position filename="gappinfo.h" line="145"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gappinfo.h" line="56">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="dup">
|
|
<callback name="dup">
|
|
<source-position filename="gappinfo.h" line="94"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10833">a duplicate of @appinfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10829">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="equal">
|
|
<callback name="equal">
|
|
<source-position filename="gappinfo.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10848">%TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10839">the first #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="appinfo2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10840">the second #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_id">
|
|
<callback name="get_id">
|
|
<source-position filename="gappinfo.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10993">a string containing the application's ID.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10983">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_name">
|
|
<callback name="get_name">
|
|
<source-position filename="gappinfo.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11003">the name of the application for @appinfo.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10999">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_description">
|
|
<callback name="get_description">
|
|
<source-position filename="gappinfo.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10927">a string containing a description of the
|
|
application @appinfo, or %NULL if none.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10923">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_executable">
|
|
<callback name="get_executable">
|
|
<source-position filename="gappinfo.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_icon">
|
|
<callback name="get_icon">
|
|
<source-position filename="gappinfo.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10976">the default #GIcon for @appinfo or %NULL
|
|
if there is no default icon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10972">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="launch">
|
|
<callback name="launch" throws="1">
|
|
<source-position filename="gappinfo.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11076">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11043">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11044">a #GList of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11045">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="supports_uris">
|
|
<callback name="supports_uris">
|
|
<source-position filename="gappinfo.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11300">%TRUE if the @appinfo supports URIs.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11296">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="supports_files">
|
|
<callback name="supports_files">
|
|
<source-position filename="gappinfo.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11290">%TRUE if the @appinfo supports files.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11286">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="launch_uris">
|
|
<callback name="launch_uris" throws="1">
|
|
<source-position filename="gappinfo.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11152">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11136">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="uris" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11137">a #GList containing URIs to launch.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11138">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="should_show">
|
|
<callback name="should_show">
|
|
<source-position filename="gappinfo.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11280">%TRUE if the @appinfo should be shown, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11275">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_as_default_for_type">
|
|
<callback name="set_as_default_for_type" throws="1">
|
|
<source-position filename="gappinfo.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11254">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11248">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11249">the content type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_as_default_for_extension">
|
|
<callback name="set_as_default_for_extension" throws="1">
|
|
<source-position filename="gappinfo.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11242">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11235">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11236">a string containing the file extension
|
|
(without the dot).</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="add_supports_type">
|
|
<callback name="add_supports_type" throws="1">
|
|
<source-position filename="gappinfo.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10766">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10759">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10760">a string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_remove_supports_type">
|
|
<callback name="can_remove_supports_type">
|
|
<source-position filename="gappinfo.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10788">%TRUE if it is possible to remove supported
|
|
content types from a given @appinfo, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10784">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="remove_supports_type">
|
|
<callback name="remove_supports_type" throws="1">
|
|
<source-position filename="gappinfo.h" line="125"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11215">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11209">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11210">a string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_delete">
|
|
<callback name="can_delete">
|
|
<source-position filename="gappinfo.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10777">%TRUE if @appinfo can be deleted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10772">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="do_delete">
|
|
<callback name="do_delete">
|
|
<source-position filename="gappinfo.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10822">%TRUE if @appinfo has been deleted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10814">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_commandline">
|
|
<callback name="get_commandline">
|
|
<source-position filename="gappinfo.h" line="130"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_display_name">
|
|
<callback name="get_display_name">
|
|
<source-position filename="gappinfo.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10939">the display name of the application for @appinfo, or the name if
|
|
no display name is available.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10934">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_as_last_used_for_type">
|
|
<callback name="set_as_last_used_for_type" throws="1">
|
|
<source-position filename="gappinfo.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11269">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11260">a #GAppInfo.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11261">the content type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_supported_types">
|
|
<callback name="get_supported_types">
|
|
<source-position filename="gappinfo.h" line="135"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11035">
|
|
a list of content types.</doc>
|
|
<array c:type="const char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11026">a #GAppInfo that can handle files</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="launch_uris_async">
|
|
<callback name="launch_uris_async">
|
|
<source-position filename="gappinfo.h" line="136"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11158">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="uris" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11159">a #GList containing URIs to launch.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11160">a #GAppLaunchContext or %NULL</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11161">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11162">a #GAsyncReadyCallback to call when the request is done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11163">data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="launch_uris_finish">
|
|
<callback name="launch_uris_finish" throws="1">
|
|
<source-position filename="gappinfo.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11184">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11178">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11179">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="AppInfoMonitor" c:symbol-prefix="app_info_monitor" c:type="GAppInfoMonitor" version="2.40" parent="GObject.Object" glib:type-name="GAppInfoMonitor" glib:get-type="g_app_info_monitor_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4652">#GAppInfoMonitor is a very simple object used for monitoring the app
|
|
info database for changes (ie: newly installed or removed
|
|
applications).
|
|
|
|
Call g_app_info_monitor_get() to get a #GAppInfoMonitor and connect
|
|
to the "changed" signal.
|
|
|
|
In the usual case, applications should try to make note of the change
|
|
(doing things like invalidating caches) but not act on it. In
|
|
particular, applications should avoid making calls to #GAppInfo APIs
|
|
in response to the change signal, deferring these until the time that
|
|
the data is actually required. The exception to this case is when
|
|
application information is actually being displayed on the screen
|
|
(eg: during a search or when the list of all applications is shown).
|
|
The reason for this is that changes to the list of installed
|
|
applications often come in groups (like during system updates) and
|
|
rescanning the list on every change is pointless and expensive.</doc>
|
|
<function name="get" c:identifier="g_app_info_monitor_get" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11189">Gets the #GAppInfoMonitor for the current thread-default main
|
|
context.
|
|
|
|
The #GAppInfoMonitor will emit a "changed" signal in the
|
|
thread-default main context whenever the list of installed
|
|
applications (as reported by g_app_info_get_all()) may have changed.
|
|
|
|
You must only call g_object_unref() on the return value from under
|
|
the same main context as you created it.</doc>
|
|
<source-position filename="gappinfo.h" line="343"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11202">a reference to a #GAppInfoMonitor</doc>
|
|
<type name="AppInfoMonitor" c:type="GAppInfoMonitor*"/>
|
|
</return-value>
|
|
</function>
|
|
<glib:signal name="changed" when="first">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="229">Signal emitted when the app info database for changes (ie: newly installed
|
|
or removed applications).</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</class>
|
|
<class name="AppLaunchContext" c:symbol-prefix="app_launch_context" c:type="GAppLaunchContext" parent="GObject.Object" glib:type-name="GAppLaunchContext" glib:get-type="g_app_launch_context_get_type" glib:type-struct="AppLaunchContextClass">
|
|
<doc xml:space="preserve" filename="gappinfo.h" line="266">Integrating the launch with the launching application. This is used to
|
|
handle for instance startup notification and launching the new application
|
|
on the same screen as the launching window.</doc>
|
|
<source-position filename="gappinfo.h" line="302"/>
|
|
<constructor name="new" c:identifier="g_app_launch_context_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11360">Creates a new application launch context. This is not normally used,
|
|
instead you instantiate a subclass of this, such as #GdkAppLaunchContext.</doc>
|
|
<source-position filename="gappinfo.h" line="307"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11366">a #GAppLaunchContext.</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<virtual-method name="get_display" invoker="get_display">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11304">Gets the display string for the @context. This is used to ensure new
|
|
applications are started on the same display as the launching
|
|
application, by setting the `DISPLAY` environment variable.</doc>
|
|
<source-position filename="gappinfo.h" line="285"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11314">a display string for the display.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11306">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11307">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11308">a #GList of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_startup_notify_id" invoker="get_startup_notify_id">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11333">Initiates startup notification for the application and returns the
|
|
`DESKTOP_STARTUP_ID` for the launched operation, if supported.
|
|
|
|
Startup notification IDs are defined in the
|
|
[FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt").</doc>
|
|
<source-position filename="gappinfo.h" line="288"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11345">a startup notification ID for the application, or %NULL if
|
|
not supported.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11335">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11336">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11337">a #GList of of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="launch_failed" invoker="launch_failed">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11350">Called when an application has failed to launch, so that it can cancel
|
|
the application startup notification started in g_app_launch_context_get_startup_notify_id().</doc>
|
|
<source-position filename="gappinfo.h" line="291"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11352">a #GAppLaunchContext.</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="startup_notify_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11353">the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="launched">
|
|
<source-position filename="gappinfo.h" line="293"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_display" c:identifier="g_app_launch_context_get_display">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11304">Gets the display string for the @context. This is used to ensure new
|
|
applications are started on the same display as the launching
|
|
application, by setting the `DISPLAY` environment variable.</doc>
|
|
<source-position filename="gappinfo.h" line="320"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11314">a display string for the display.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11306">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11307">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11308">a #GList of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_environment" c:identifier="g_app_launch_context_get_environment" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11318">Gets the complete environment variable list to be passed to
|
|
the child process when @context is used to launch an application.
|
|
This is a %NULL-terminated array of strings, where each string has
|
|
the form `KEY=VALUE`.</doc>
|
|
<source-position filename="gappinfo.h" line="317"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11327">
|
|
the child's environment</doc>
|
|
<array c:type="char**">
|
|
<type name="filename"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11320">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_startup_notify_id" c:identifier="g_app_launch_context_get_startup_notify_id">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11333">Initiates startup notification for the application and returns the
|
|
`DESKTOP_STARTUP_ID` for the launched operation, if supported.
|
|
|
|
Startup notification IDs are defined in the
|
|
[FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt").</doc>
|
|
<source-position filename="gappinfo.h" line="324"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11345">a startup notification ID for the application, or %NULL if
|
|
not supported.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11335">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11336">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11337">a #GList of of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch_failed" c:identifier="g_app_launch_context_launch_failed">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11350">Called when an application has failed to launch, so that it can cancel
|
|
the application startup notification started in g_app_launch_context_get_startup_notify_id().</doc>
|
|
<source-position filename="gappinfo.h" line="328"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11352">a #GAppLaunchContext.</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="startup_notify_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11353">the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="setenv" c:identifier="g_app_launch_context_setenv" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11370">Arranges for @variable to be set to @value in the child's
|
|
environment when @context is used to launch an application.</doc>
|
|
<source-position filename="gappinfo.h" line="310"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11372">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="variable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11373">the environment variable to set</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11374">the value for to set the variable to.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unsetenv" c:identifier="g_app_launch_context_unsetenv" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11383">Arranges for @variable to be unset in the child's environment
|
|
when @context is used to launch an application.</doc>
|
|
<source-position filename="gappinfo.h" line="314"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11385">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</instance-parameter>
|
|
<parameter name="variable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11386">the environment variable to remove</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="AppLaunchContextPrivate" c:type="GAppLaunchContextPrivate*"/>
|
|
</field>
|
|
<glib:signal name="launch-failed" when="last" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="237">The ::launch-failed signal is emitted when a #GAppInfo launch
|
|
fails. The startup notification id is provided, so that the launcher
|
|
can cancel the startup notification.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="startup_notify_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="240">the startup notification id for the failed launch</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="launched" when="last" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="250">The ::launched signal is emitted when a #GAppInfo is successfully
|
|
launched. The @platform_data is an GVariant dictionary mapping
|
|
strings to variants (ie a{sv}), which contains additional,
|
|
platform-specific data about this launch. On UNIX, at least the
|
|
"pid" and "startup-notification-id" keys will be present.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="253">the #GAppInfo that was just launched</doc>
|
|
<type name="AppInfo"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="254">additional platform-specific data for this launch</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="AppLaunchContextClass" c:type="GAppLaunchContextClass" glib:is-gtype-struct-for="AppLaunchContext">
|
|
<source-position filename="gappinfo.h" line="302"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_display">
|
|
<callback name="get_display">
|
|
<source-position filename="gappinfo.h" line="285"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11314">a display string for the display.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11306">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11307">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11308">a #GList of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_startup_notify_id">
|
|
<callback name="get_startup_notify_id">
|
|
<source-position filename="gappinfo.h" line="288"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11345">a startup notification ID for the application, or %NULL if
|
|
not supported.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11335">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11336">a #GAppInfo</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11337">a #GList of of #GFile objects</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="File"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="launch_failed">
|
|
<callback name="launch_failed">
|
|
<source-position filename="gappinfo.h" line="291"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="context" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11352">a #GAppLaunchContext.</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="startup_notify_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11353">the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="launched">
|
|
<callback name="launched">
|
|
<source-position filename="gappinfo.h" line="293"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="context" transfer-ownership="none">
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gappinfo.h" line="298"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gappinfo.h" line="299"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gappinfo.h" line="300"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gappinfo.h" line="301"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="AppLaunchContextPrivate" c:type="GAppLaunchContextPrivate" disguised="1">
|
|
<source-position filename="gappinfo.h" line="45"/>
|
|
</record>
|
|
<class name="Application" c:symbol-prefix="application" c:type="GApplication" version="2.28" parent="GObject.Object" glib:type-name="GApplication" glib:get-type="g_application_get_type" glib:type-struct="ApplicationClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4678">A #GApplication is the foundation of an application. It wraps some
|
|
low-level platform-specific services and is intended to act as the
|
|
foundation for higher-level application classes such as
|
|
#GtkApplication or #MxApplication. In general, you should not use
|
|
this class outside of a higher level framework.
|
|
|
|
GApplication provides convenient life cycle management by maintaining
|
|
a "use count" for the primary application instance. The use count can
|
|
be changed using g_application_hold() and g_application_release(). If
|
|
it drops to zero, the application exits. Higher-level classes such as
|
|
#GtkApplication employ the use count to ensure that the application
|
|
stays alive as long as it has any opened windows.
|
|
|
|
Another feature that GApplication (optionally) provides is process
|
|
uniqueness. Applications can make use of this functionality by
|
|
providing a unique application ID. If given, only one application
|
|
with this ID can be running at a time per session. The session
|
|
concept is platform-dependent, but corresponds roughly to a graphical
|
|
desktop login. When your application is launched again, its
|
|
arguments are passed through platform communication to the already
|
|
running program. The already running instance of the program is
|
|
called the "primary instance"; for non-unique applications this is
|
|
the always the current instance. On Linux, the D-Bus session bus
|
|
is used for communication.
|
|
|
|
The use of #GApplication differs from some other commonly-used
|
|
uniqueness libraries (such as libunique) in important ways. The
|
|
application is not expected to manually register itself and check
|
|
if it is the primary instance. Instead, the main() function of a
|
|
#GApplication should do very little more than instantiating the
|
|
application instance, possibly connecting signal handlers, then
|
|
calling g_application_run(). All checks for uniqueness are done
|
|
internally. If the application is the primary instance then the
|
|
startup signal is emitted and the mainloop runs. If the application
|
|
is not the primary instance then a signal is sent to the primary
|
|
instance and g_application_run() promptly returns. See the code
|
|
examples below.
|
|
|
|
If used, the expected form of an application identifier is the same as
|
|
that of of a
|
|
[D-Bus well-known bus name](https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-bus).
|
|
Examples include: `com.example.MyApp`, `org.example.internal_apps.Calculator`,
|
|
`org._7_zip.Archiver`.
|
|
For details on valid application identifiers, see g_application_id_is_valid().
|
|
|
|
On Linux, the application identifier is claimed as a well-known bus name
|
|
on the user's session bus. This means that the uniqueness of your
|
|
application is scoped to the current session. It also means that your
|
|
application may provide additional services (through registration of other
|
|
object paths) at that bus name. The registration of these object paths
|
|
should be done with the shared GDBus session bus. Note that due to the
|
|
internal architecture of GDBus, method calls can be dispatched at any time
|
|
(even if a main loop is not running). For this reason, you must ensure that
|
|
any object paths that you wish to register are registered before #GApplication
|
|
attempts to acquire the bus name of your application (which happens in
|
|
g_application_register()). Unfortunately, this means that you cannot use
|
|
g_application_get_is_remote() to decide if you want to register object paths.
|
|
|
|
GApplication also implements the #GActionGroup and #GActionMap
|
|
interfaces and lets you easily export actions by adding them with
|
|
g_action_map_add_action(). When invoking an action by calling
|
|
g_action_group_activate_action() on the application, it is always
|
|
invoked in the primary instance. The actions are also exported on
|
|
the session bus, and GIO provides the #GDBusActionGroup wrapper to
|
|
conveniently access them remotely. GIO provides a #GDBusMenuModel wrapper
|
|
for remote access to exported #GMenuModels.
|
|
|
|
There is a number of different entry points into a GApplication:
|
|
|
|
- via 'Activate' (i.e. just starting the application)
|
|
|
|
- via 'Open' (i.e. opening some files)
|
|
|
|
- by handling a command-line
|
|
|
|
- via activating an action
|
|
|
|
The #GApplication::startup signal lets you handle the application
|
|
initialization for all of these in a single place.
|
|
|
|
Regardless of which of these entry points is used to start the
|
|
application, GApplication passes some "platform data from the
|
|
launching instance to the primary instance, in the form of a
|
|
#GVariant dictionary mapping strings to variants. To use platform
|
|
data, override the @before_emit or @after_emit virtual functions
|
|
in your #GApplication subclass. When dealing with
|
|
#GApplicationCommandLine objects, the platform data is
|
|
directly available via g_application_command_line_get_cwd(),
|
|
g_application_command_line_get_environ() and
|
|
g_application_command_line_get_platform_data().
|
|
|
|
As the name indicates, the platform data may vary depending on the
|
|
operating system, but it always includes the current directory (key
|
|
"cwd"), and optionally the environment (ie the set of environment
|
|
variables and their values) of the calling process (key "environ").
|
|
The environment is only added to the platform data if the
|
|
%G_APPLICATION_SEND_ENVIRONMENT flag is set. #GApplication subclasses
|
|
can add their own platform data by overriding the @add_platform_data
|
|
virtual function. For instance, #GtkApplication adds startup notification
|
|
data in this way.
|
|
|
|
To parse commandline arguments you may handle the
|
|
#GApplication::command-line signal or override the local_command_line()
|
|
vfunc, to parse them in either the primary instance or the local instance,
|
|
respectively.
|
|
|
|
For an example of opening files with a GApplication, see
|
|
[gapplication-example-open.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-open.c).
|
|
|
|
For an example of using actions with GApplication, see
|
|
[gapplication-example-actions.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-actions.c).
|
|
|
|
For an example of using extra D-Bus hooks with GApplication, see
|
|
[gapplication-example-dbushooks.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-dbushooks.c).</doc>
|
|
<source-position filename="gapplication.h" line="119"/>
|
|
<implements name="ActionGroup"/>
|
|
<implements name="ActionMap"/>
|
|
<constructor name="new" c:identifier="g_application_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12054">Creates a new #GApplication instance.
|
|
|
|
If non-%NULL, the application id must be valid. See
|
|
g_application_id_is_valid().
|
|
|
|
If no application ID is given then some features of #GApplication
|
|
(most notably application uniqueness) will be disabled.</doc>
|
|
<source-position filename="gapplication.h" line="128"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12067">a new #GApplication instance</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application_id" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12056">the application id</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12057">the application flags</doc>
|
|
<type name="ApplicationFlags" c:type="GApplicationFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="get_default" c:identifier="g_application_get_default" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11865">Returns the default #GApplication instance for this process.
|
|
|
|
Normally there is only one #GApplication per process and it becomes
|
|
the default when it is created. You can exercise more control over
|
|
this by using g_application_set_default().
|
|
|
|
If there is no default application then %NULL is returned.</doc>
|
|
<source-position filename="gapplication.h" line="221"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11876">the default application for this process, or %NULL</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="id_is_valid" c:identifier="g_application_id_is_valid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11981">Checks if @application_id is a valid application identifier.
|
|
|
|
A valid ID is required for calls to g_application_new() and
|
|
g_application_set_application_id().
|
|
|
|
Application identifiers follow the same format as
|
|
[D-Bus well-known bus names](https://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-bus).
|
|
For convenience, the restrictions on application identifiers are
|
|
reproduced here:
|
|
|
|
- Application identifiers are composed of 1 or more elements separated by a
|
|
period (`.`) character. All elements must contain at least one character.
|
|
|
|
- Each element must only contain the ASCII characters `[A-Z][a-z][0-9]_-`,
|
|
with `-` discouraged in new application identifiers. Each element must not
|
|
begin with a digit.
|
|
|
|
- Application identifiers must contain at least one `.` (period) character
|
|
(and thus at least two elements).
|
|
|
|
- Application identifiers must not begin with a `.` (period) character.
|
|
|
|
- Application identifiers must not exceed 255 characters.
|
|
|
|
Note that the hyphen (`-`) character is allowed in application identifiers,
|
|
but is problematic or not allowed in various specifications and APIs that
|
|
refer to D-Bus, such as
|
|
[Flatpak application IDs](http://docs.flatpak.org/en/latest/introduction.html#identifiers),
|
|
the
|
|
[`DBusActivatable` interface in the Desktop Entry Specification](https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#dbus),
|
|
and the convention that an application's "main" interface and object path
|
|
resemble its application identifier and bus name. To avoid situations that
|
|
require special-case handling, it is recommended that new application
|
|
identifiers consistently replace hyphens with underscores.
|
|
|
|
Like D-Bus interface names, application identifiers should start with the
|
|
reversed DNS domain name of the author of the interface (in lower-case), and
|
|
it is conventional for the rest of the application identifier to consist of
|
|
words run together, with initial capital letters.
|
|
|
|
As with D-Bus interface names, if the author's DNS domain name contains
|
|
hyphen/minus characters they should be replaced by underscores, and if it
|
|
contains leading digits they should be escaped by prepending an underscore.
|
|
For example, if the owner of 7-zip.org used an application identifier for an
|
|
archiving application, it might be named `org._7_zip.Archiver`.</doc>
|
|
<source-position filename="gapplication.h" line="125"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12031">%TRUE if @application_id is valid</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11983">a potential application identifier</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="activate" invoker="activate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11395">Activates the application.
|
|
|
|
In essence, this results in the #GApplication::activate signal being
|
|
emitted in the primary instance.
|
|
|
|
The application must be registered before calling this function.</doc>
|
|
<source-position filename="gapplication.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11397">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="add_platform_data">
|
|
<source-position filename="gapplication.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="builder" transfer-ownership="none">
|
|
<type name="GLib.VariantBuilder" c:type="GVariantBuilder*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="after_emit">
|
|
<source-position filename="gapplication.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="before_emit">
|
|
<source-position filename="gapplication.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="command_line">
|
|
<source-position filename="gapplication.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="command_line" transfer-ownership="none">
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="dbus_register" throws="1">
|
|
<source-position filename="gapplication.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="dbus_unregister">
|
|
<source-position filename="gapplication.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handle_local_options">
|
|
<source-position filename="gapplication.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="options" transfer-ownership="none">
|
|
<type name="GLib.VariantDict" c:type="GVariantDict*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="local_command_line">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="73">This virtual function is always invoked in the local instance. It
|
|
gets passed a pointer to a %NULL-terminated copy of @argv and is
|
|
expected to remove arguments that it handled (shifting up remaining
|
|
arguments).
|
|
|
|
The last argument to local_command_line() is a pointer to the @status
|
|
variable which can used to set the exit status that is returned from
|
|
g_application_run().
|
|
|
|
See g_application_run() for more details on #GApplication startup.</doc>
|
|
<source-position filename="gapplication.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="90">%TRUE if the commandline has been completely handled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="75">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="arguments" direction="inout" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="76">array of command line arguments</doc>
|
|
<array c:type="gchar***">
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="exit_status" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="77">exit status to fill after processing the command line.</doc>
|
|
<type name="gint" c:type="int*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="name_lost">
|
|
<source-position filename="gapplication.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="open" invoker="open" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12071">Opens the given files.
|
|
|
|
In essence, this results in the #GApplication::open signal being emitted
|
|
in the primary instance.
|
|
|
|
@n_files must be greater than zero.
|
|
|
|
@hint is simply passed through to the ::open signal. It is
|
|
intended to be used by applications that have multiple modes for
|
|
opening files (eg: "view" vs "edit", etc). Unless you have a need
|
|
for this functionality, you should use "".
|
|
|
|
The application must be registered before calling this function
|
|
and it must have the %G_APPLICATION_HANDLES_OPEN flag set.</doc>
|
|
<source-position filename="gapplication.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12073">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12074">an array of #GFiles to open</doc>
|
|
<array length="1" zero-terminated="0" c:type="GFile**">
|
|
<type name="File" c:type="GFile*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12075">the length of the @files array</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="hint" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12076">a hint (or ""), but never %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="quit_mainloop">
|
|
<source-position filename="gapplication.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="run_mainloop">
|
|
<source-position filename="gapplication.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="shutdown">
|
|
<source-position filename="gapplication.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="startup">
|
|
<source-position filename="gapplication.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="activate" c:identifier="g_application_activate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11395">Activates the application.
|
|
|
|
In essence, this results in the #GApplication::activate signal being
|
|
emitted in the primary instance.
|
|
|
|
The application must be registered before calling this function.</doc>
|
|
<source-position filename="gapplication.h" line="204"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11397">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_main_option" c:identifier="g_application_add_main_option" version="2.42">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11410">Add an option to be handled by @application.
|
|
|
|
Calling this function is the equivalent of calling
|
|
g_application_add_main_option_entries() with a single #GOptionEntry
|
|
that has its arg_data member set to %NULL.
|
|
|
|
The parsed arguments will be packed into a #GVariantDict which
|
|
is passed to #GApplication::handle-local-options. If
|
|
%G_APPLICATION_HANDLES_COMMAND_LINE is set, then it will also
|
|
be sent to the primary instance. See
|
|
g_application_add_main_option_entries() for more details.
|
|
|
|
See #GOptionEntry for more documentation of the arguments.</doc>
|
|
<source-position filename="gapplication.h" line="169"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11412">the #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="long_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11413">the long name of an option used to specify it in a commandline</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="short_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11414">the short name of an option</doc>
|
|
<type name="gchar" c:type="char"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11415">flags from #GOptionFlags</doc>
|
|
<type name="GLib.OptionFlags" c:type="GOptionFlags"/>
|
|
</parameter>
|
|
<parameter name="arg" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11416">the type of the option, as a #GOptionArg</doc>
|
|
<type name="GLib.OptionArg" c:type="GOptionArg"/>
|
|
</parameter>
|
|
<parameter name="description" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11417">the description for the option in `--help` output</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="arg_description" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11418">the placeholder to use for the extra argument
|
|
parsed by the option in `--help` output</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_main_option_entries" c:identifier="g_application_add_main_option_entries" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11439">Adds main option entries to be handled by @application.
|
|
|
|
This function is comparable to g_option_context_add_main_entries().
|
|
|
|
After the commandline arguments are parsed, the
|
|
#GApplication::handle-local-options signal will be emitted. At this
|
|
point, the application can inspect the values pointed to by @arg_data
|
|
in the given #GOptionEntrys.
|
|
|
|
Unlike #GOptionContext, #GApplication supports giving a %NULL
|
|
@arg_data for a non-callback #GOptionEntry. This results in the
|
|
argument in question being packed into a #GVariantDict which is also
|
|
passed to #GApplication::handle-local-options, where it can be
|
|
inspected and modified. If %G_APPLICATION_HANDLES_COMMAND_LINE is
|
|
set, then the resulting dictionary is sent to the primary instance,
|
|
where g_application_command_line_get_options_dict() will return it.
|
|
This "packing" is done according to the type of the argument --
|
|
booleans for normal flags, strings for strings, bytestrings for
|
|
filenames, etc. The packing only occurs if the flag is given (ie: we
|
|
do not pack a "false" #GVariant in the case that a flag is missing).
|
|
|
|
In general, it is recommended that all commandline arguments are
|
|
parsed locally. The options dictionary should then be used to
|
|
transmit the result of the parsing to the primary instance, where
|
|
g_variant_dict_lookup() can be used. For local options, it is
|
|
possible to either use @arg_data in the usual way, or to consult (and
|
|
potentially remove) the option from the options dictionary.
|
|
|
|
This function is new in GLib 2.40. Before then, the only real choice
|
|
was to send all of the commandline arguments (options and all) to the
|
|
primary instance for handling. #GApplication ignored them completely
|
|
on the local side. Calling this function "opts in" to the new
|
|
behaviour, and in particular, means that unrecognised options will be
|
|
treated as errors. Unrecognised options have never been ignored when
|
|
%G_APPLICATION_HANDLES_COMMAND_LINE is unset.
|
|
|
|
If #GApplication::handle-local-options needs to see the list of
|
|
filenames, then the use of %G_OPTION_REMAINING is recommended. If
|
|
@arg_data is %NULL then %G_OPTION_REMAINING can be used as a key into
|
|
the options dictionary. If you do use %G_OPTION_REMAINING then you
|
|
need to handle these arguments for yourself because once they are
|
|
consumed, they will no longer be visible to the default handling
|
|
(which treats them as filenames to be opened).
|
|
|
|
It is important to use the proper GVariant format when retrieving
|
|
the options with g_variant_dict_lookup():
|
|
- for %G_OPTION_ARG_NONE, use b
|
|
- for %G_OPTION_ARG_STRING, use &s
|
|
- for %G_OPTION_ARG_INT, use i
|
|
- for %G_OPTION_ARG_INT64, use x
|
|
- for %G_OPTION_ARG_DOUBLE, use d
|
|
- for %G_OPTION_ARG_FILENAME, use ^ay
|
|
- for %G_OPTION_ARG_STRING_ARRAY, use &as
|
|
- for %G_OPTION_ARG_FILENAME_ARRAY, use ^aay</doc>
|
|
<source-position filename="gapplication.h" line="165"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11441">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11442">a
|
|
%NULL-terminated list of #GOptionEntrys</doc>
|
|
<array c:type="const GOptionEntry*">
|
|
<type name="GLib.OptionEntry"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_option_group" c:identifier="g_application_add_option_group" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11504">Adds a #GOptionGroup to the commandline handling of @application.
|
|
|
|
This function is comparable to g_option_context_add_group().
|
|
|
|
Unlike g_application_add_main_option_entries(), this function does
|
|
not deal with %NULL @arg_data and never transmits options to the
|
|
primary instance.
|
|
|
|
The reason for that is because, by the time the options arrive at the
|
|
primary instance, it is typically too late to do anything with them.
|
|
Taking the GTK option group as an example: GTK will already have been
|
|
initialised by the time the #GApplication::command-line handler runs.
|
|
In the case that this is not the first-running instance of the
|
|
application, the existing instance may already have been running for
|
|
a very long time.
|
|
|
|
This means that the options from #GOptionGroup are only really usable
|
|
in the case that the instance of the application being run is the
|
|
first instance. Passing options like `--display=` or `--gdk-debug=`
|
|
on future runs will have no effect on the existing primary instance.
|
|
|
|
Calling this function will cause the options in the supplied option
|
|
group to be parsed, but it does not cause you to be "opted in" to the
|
|
new functionality whereby unrecognised options are rejected even if
|
|
%G_APPLICATION_HANDLES_COMMAND_LINE was given.</doc>
|
|
<source-position filename="gapplication.h" line="177"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11506">the #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="group" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11507">a #GOptionGroup</doc>
|
|
<type name="GLib.OptionGroup" c:type="GOptionGroup*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="bind_busy_property" c:identifier="g_application_bind_busy_property" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11539">Marks @application as busy (see g_application_mark_busy()) while
|
|
@property on @object is %TRUE.
|
|
|
|
The binding holds a reference to @application while it is active, but
|
|
not to @object. Instead, the binding is destroyed when @object is
|
|
finalized.</doc>
|
|
<source-position filename="gapplication.h" line="241"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11541">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11542">a #GObject</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="property" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11543">the name of a boolean property of @object</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_application_id" c:identifier="g_application_get_application_id" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11807">Gets the unique identifier for @application.</doc>
|
|
<source-position filename="gapplication.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11813">the identifier for @application, owned by @application</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11809">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_dbus_connection" c:identifier="g_application_get_dbus_connection" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11818">Gets the #GDBusConnection being used by the application, or %NULL.
|
|
|
|
If #GApplication is using its D-Bus backend then this function will
|
|
return the #GDBusConnection being used for uniqueness and
|
|
communication with the desktop environment and other instances of the
|
|
application.
|
|
|
|
If #GApplication is not using D-Bus then this function will return
|
|
%NULL. This includes the situation where the D-Bus backend would
|
|
normally be in use but we were unable to connect to the bus.
|
|
|
|
This function must not be called before the application has been
|
|
registered. See g_application_get_is_registered().</doc>
|
|
<source-position filename="gapplication.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11836">a #GDBusConnection, or %NULL</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11820">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_dbus_object_path" c:identifier="g_application_get_dbus_object_path" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11841">Gets the D-Bus object path being used by the application, or %NULL.
|
|
|
|
If #GApplication is using its D-Bus backend then this function will
|
|
return the D-Bus object path that #GApplication is using. If the
|
|
application is the primary instance then there is an object published
|
|
at this path. If the application is not the primary instance then
|
|
the result of this function is undefined.
|
|
|
|
If #GApplication is not using D-Bus then this function will return
|
|
%NULL. This includes the situation where the D-Bus backend would
|
|
normally be in use but we were unable to connect to the bus.
|
|
|
|
This function must not be called before the application has been
|
|
registered. See g_application_get_is_registered().</doc>
|
|
<source-position filename="gapplication.h" line="140"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11860">the object path, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11843">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_application_get_flags" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11881">Gets the flags for @application.
|
|
|
|
See #GApplicationFlags.</doc>
|
|
<source-position filename="gapplication.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11889">the flags for @application</doc>
|
|
<type name="ApplicationFlags" c:type="GApplicationFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11883">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_inactivity_timeout" c:identifier="g_application_get_inactivity_timeout" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11894">Gets the current inactivity timeout for the application.
|
|
|
|
This is the amount of time (in milliseconds) after the last call to
|
|
g_application_release() before the application stops running.</doc>
|
|
<source-position filename="gapplication.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11903">the timeout, in milliseconds</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11896">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_busy" c:identifier="g_application_get_is_busy" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11908">Gets the application's current busy state, as set through
|
|
g_application_mark_busy() or g_application_bind_busy_property().</doc>
|
|
<source-position filename="gapplication.h" line="230"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11915">%TRUE if @application is currenty marked as busy</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11910">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_registered" c:identifier="g_application_get_is_registered" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11920">Checks if @application is registered.
|
|
|
|
An application is registered if g_application_register() has been
|
|
successfully called.</doc>
|
|
<source-position filename="gapplication.h" line="189"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11929">%TRUE if @application is registered</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11922">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_remote" c:identifier="g_application_get_is_remote" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11934">Checks if @application is remote.
|
|
|
|
If @application is remote then it means that another instance of
|
|
application already exists (the 'primary' instance). Calls to
|
|
perform actions on @application will result in the actions being
|
|
performed by the primary instance.
|
|
|
|
The value of this property cannot be accessed before
|
|
g_application_register() has been called. See
|
|
g_application_get_is_registered().</doc>
|
|
<source-position filename="gapplication.h" line="191"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11949">%TRUE if @application is remote</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11936">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_resource_base_path" c:identifier="g_application_get_resource_base_path" version="2.42">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11954">Gets the resource base path of @application.
|
|
|
|
See g_application_set_resource_base_path() for more information.</doc>
|
|
<source-position filename="gapplication.h" line="155"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11962">the base resource path, if one is set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11956">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="hold" c:identifier="g_application_hold">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11967">Increases the use count of @application.
|
|
|
|
Use this function to indicate that the application has a reason to
|
|
continue to run. For example, g_application_hold() is called by GTK+
|
|
when a toplevel window is on the screen.
|
|
|
|
To cancel the hold, call g_application_release().</doc>
|
|
<source-position filename="gapplication.h" line="199"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11969">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="mark_busy" c:identifier="g_application_mark_busy" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12035">Increases the busy count of @application.
|
|
|
|
Use this function to indicate that the application is busy, for instance
|
|
while a long running operation is pending.
|
|
|
|
The busy state will be exposed to other processes, so a session shell will
|
|
use that information to indicate the state to the user (e.g. with a
|
|
spinner).
|
|
|
|
To cancel the busy indication, use g_application_unmark_busy().</doc>
|
|
<source-position filename="gapplication.h" line="226"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12037">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="open" c:identifier="g_application_open" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12071">Opens the given files.
|
|
|
|
In essence, this results in the #GApplication::open signal being emitted
|
|
in the primary instance.
|
|
|
|
@n_files must be greater than zero.
|
|
|
|
@hint is simply passed through to the ::open signal. It is
|
|
intended to be used by applications that have multiple modes for
|
|
opening files (eg: "view" vs "edit", etc). Unless you have a need
|
|
for this functionality, you should use "".
|
|
|
|
The application must be registered before calling this function
|
|
and it must have the %G_APPLICATION_HANDLES_OPEN flag set.</doc>
|
|
<source-position filename="gapplication.h" line="207"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12073">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12074">an array of #GFiles to open</doc>
|
|
<array length="1" zero-terminated="0" c:type="GFile**">
|
|
<type name="File" c:type="GFile*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12075">the length of the @files array</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="hint" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12076">a hint (or ""), but never %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="quit" c:identifier="g_application_quit" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12097">Immediately quits the application.
|
|
|
|
Upon return to the mainloop, g_application_run() will return,
|
|
calling only the 'shutdown' function before doing so.
|
|
|
|
The hold count is ignored.
|
|
Take care if your code has called g_application_hold() on the application and
|
|
is therefore still expecting it to exist.
|
|
(Note that you may have called g_application_hold() indirectly, for example
|
|
through gtk_application_add_window().)
|
|
|
|
The result of calling g_application_run() again after it returns is
|
|
unspecified.</doc>
|
|
<source-position filename="gapplication.h" line="218"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12099">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="register" c:identifier="g_application_register" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12119">Attempts registration of the application.
|
|
|
|
This is the point at which the application discovers if it is the
|
|
primary instance or merely acting as a remote for an already-existing
|
|
primary instance. This is implemented by attempting to acquire the
|
|
application identifier as a unique bus name on the session bus using
|
|
GDBus.
|
|
|
|
If there is no application ID or if %G_APPLICATION_NON_UNIQUE was
|
|
given, then this process will always become the primary instance.
|
|
|
|
Due to the internal architecture of GDBus, method calls can be
|
|
dispatched at any time (even if a main loop is not running). For
|
|
this reason, you must ensure that any object paths that you wish to
|
|
register are registered before calling this function.
|
|
|
|
If the application has already been registered then %TRUE is
|
|
returned with no work performed.
|
|
|
|
The #GApplication::startup signal is emitted if registration succeeds
|
|
and @application is the primary instance (including the non-unique
|
|
case).
|
|
|
|
In the event of an error (such as @cancellable being cancelled, or a
|
|
failure to connect to the session bus), %FALSE is returned and @error
|
|
is set appropriately.
|
|
|
|
Note: the return value of this function is not an indicator that this
|
|
instance is or is not the primary instance of the application. See
|
|
g_application_get_is_remote() for that.</doc>
|
|
<source-position filename="gapplication.h" line="194"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12156">%TRUE if registration succeeded</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12121">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12122">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="release" c:identifier="g_application_release">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12161">Decrease the use count of @application.
|
|
|
|
When the use count reaches zero, the application will stop running.
|
|
|
|
Never call this function except to cancel the effect of a previous
|
|
call to g_application_hold().</doc>
|
|
<source-position filename="gapplication.h" line="201"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12163">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="run" c:identifier="g_application_run" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12174">Runs the application.
|
|
|
|
This function is intended to be run from main() and its return value
|
|
is intended to be returned by main(). Although you are expected to pass
|
|
the @argc, @argv parameters from main() to this function, it is possible
|
|
to pass %NULL if @argv is not available or commandline handling is not
|
|
required. Note that on Windows, @argc and @argv are ignored, and
|
|
g_win32_get_command_line() is called internally (for proper support
|
|
of Unicode commandline arguments).
|
|
|
|
#GApplication will attempt to parse the commandline arguments. You
|
|
can add commandline flags to the list of recognised options by way of
|
|
g_application_add_main_option_entries(). After this, the
|
|
#GApplication::handle-local-options signal is emitted, from which the
|
|
application can inspect the values of its #GOptionEntrys.
|
|
|
|
#GApplication::handle-local-options is a good place to handle options
|
|
such as `--version`, where an immediate reply from the local process is
|
|
desired (instead of communicating with an already-running instance).
|
|
A #GApplication::handle-local-options handler can stop further processing
|
|
by returning a non-negative value, which then becomes the exit status of
|
|
the process.
|
|
|
|
What happens next depends on the flags: if
|
|
%G_APPLICATION_HANDLES_COMMAND_LINE was specified then the remaining
|
|
commandline arguments are sent to the primary instance, where a
|
|
#GApplication::command-line signal is emitted. Otherwise, the
|
|
remaining commandline arguments are assumed to be a list of files.
|
|
If there are no files listed, the application is activated via the
|
|
#GApplication::activate signal. If there are one or more files, and
|
|
%G_APPLICATION_HANDLES_OPEN was specified then the files are opened
|
|
via the #GApplication::open signal.
|
|
|
|
If you are interested in doing more complicated local handling of the
|
|
commandline then you should implement your own #GApplication subclass
|
|
and override local_command_line(). In this case, you most likely want
|
|
to return %TRUE from your local_command_line() implementation to
|
|
suppress the default handling. See
|
|
[gapplication-example-cmdline2.c][gapplication-example-cmdline2]
|
|
for an example.
|
|
|
|
If, after the above is done, the use count of the application is zero
|
|
then the exit status is returned immediately. If the use count is
|
|
non-zero then the default main context is iterated until the use count
|
|
falls to zero, at which point 0 is returned.
|
|
|
|
If the %G_APPLICATION_IS_SERVICE flag is set, then the service will
|
|
run for as much as 10 seconds with a use count of zero while waiting
|
|
for the message that caused the activation to arrive. After that,
|
|
if the use count falls to zero the application will exit immediately,
|
|
except in the case that g_application_set_inactivity_timeout() is in
|
|
use.
|
|
|
|
This function sets the prgname (g_set_prgname()), if not already set,
|
|
to the basename of argv[0].
|
|
|
|
Much like g_main_loop_run(), this function will acquire the main context
|
|
for the duration that the application is running.
|
|
|
|
Since 2.40, applications that are not explicitly flagged as services
|
|
or launchers (ie: neither %G_APPLICATION_IS_SERVICE or
|
|
%G_APPLICATION_IS_LAUNCHER are given as flags) will check (from the
|
|
default handler for local_command_line) if "--gapplication-service"
|
|
was given in the command line. If this flag is present then normal
|
|
commandline processing is interrupted and the
|
|
%G_APPLICATION_IS_SERVICE flag is set. This provides a "compromise"
|
|
solution whereby running an application directly from the commandline
|
|
will invoke it in the normal way (which can be useful for debugging)
|
|
while still allowing applications to be D-Bus activated in service
|
|
mode. The D-Bus service file should invoke the executable with
|
|
"--gapplication-service" as the sole commandline argument. This
|
|
approach is suitable for use by most graphical applications but
|
|
should not be used from applications like editors that need precise
|
|
control over when processes invoked via the commandline will exit and
|
|
what their exit status will be.</doc>
|
|
<source-position filename="gapplication.h" line="213"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12257">the exit status</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12176">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="argc" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12177">the argc from main() (or 0 if @argv is %NULL)</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="argv" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12178">
|
|
the argv from main(), or %NULL</doc>
|
|
<array length="0" zero-terminated="0" c:type="char**">
|
|
<type name="filename"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_notification" c:identifier="g_application_send_notification" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12262">Sends a notification on behalf of @application to the desktop shell.
|
|
There is no guarantee that the notification is displayed immediately,
|
|
or even at all.
|
|
|
|
Notifications may persist after the application exits. It will be
|
|
D-Bus-activated when the notification or one of its actions is
|
|
activated.
|
|
|
|
Modifying @notification after this call has no effect. However, the
|
|
object can be reused for a later call to this function.
|
|
|
|
@id may be any string that uniquely identifies the event for the
|
|
application. It does not need to be in any special format. For
|
|
example, "new-message" might be appropriate for a notification about
|
|
new messages.
|
|
|
|
If a previous notification was sent with the same @id, it will be
|
|
replaced with @notification and shown again as if it was a new
|
|
notification. This works even for notifications sent from a previous
|
|
execution of the application, as long as @id is the same string.
|
|
|
|
@id may be %NULL, but it is impossible to replace or withdraw
|
|
notifications without an id.
|
|
|
|
If @notification is no longer relevant, it can be withdrawn with
|
|
g_application_withdraw_notification().</doc>
|
|
<source-position filename="gapplication.h" line="233"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12264">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="id" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12265">id of the notification, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12266">the #GNotification to send</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_action_group" c:identifier="g_application_set_action_group" version="2.28" deprecated="1" deprecated-version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12299">This used to be how actions were associated with a #GApplication.
|
|
Now there is #GActionMap for that.</doc>
|
|
<doc-deprecated xml:space="preserve">Use the #GActionMap interface instead. Never ever
|
|
mix use of this API with use of #GActionMap on the same @application
|
|
or things will go very badly wrong. This function is known to
|
|
introduce buggy behaviour (ie: signals not emitted on changes to the
|
|
action group), so you should really use #GActionMap instead.</doc-deprecated>
|
|
<source-position filename="gapplication.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12301">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_group" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12302">a #GActionGroup, or %NULL</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_application_id" c:identifier="g_application_set_application_id" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12316">Sets the unique identifier for @application.
|
|
|
|
The application id can only be modified if @application has not yet
|
|
been registered.
|
|
|
|
If non-%NULL, the application id must be valid. See
|
|
g_application_id_is_valid().</doc>
|
|
<source-position filename="gapplication.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12318">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="application_id" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12319">the identifier for @application</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_default" c:identifier="g_application_set_default" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12333">Sets or unsets the default application for the process, as returned
|
|
by g_application_get_default().
|
|
|
|
This function does not take its own reference on @application. If
|
|
@application is destroyed then the default application will revert
|
|
back to %NULL.</doc>
|
|
<source-position filename="gapplication.h" line="223"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12335">the application to set as default, or %NULL</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flags" c:identifier="g_application_set_flags" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12348">Sets the flags for @application.
|
|
|
|
The flags can only be modified if @application has not yet been
|
|
registered.
|
|
|
|
See #GApplicationFlags.</doc>
|
|
<source-position filename="gapplication.h" line="151"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12350">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12351">the flags for @application</doc>
|
|
<type name="ApplicationFlags" c:type="GApplicationFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_inactivity_timeout" c:identifier="g_application_set_inactivity_timeout" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12364">Sets the current inactivity timeout for the application.
|
|
|
|
This is the amount of time (in milliseconds) after the last call to
|
|
g_application_release() before the application stops running.
|
|
|
|
This call has no side effects of its own. The value set here is only
|
|
used for next time g_application_release() drops the use count to
|
|
zero. Any timeouts currently in progress are not impacted.</doc>
|
|
<source-position filename="gapplication.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12366">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="inactivity_timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12367">the timeout, in milliseconds</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_option_context_description" c:identifier="g_application_set_option_context_description" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12382">Adds a description to the @application option context.
|
|
|
|
See g_option_context_set_description() for more information.</doc>
|
|
<source-position filename="gapplication.h" line="186"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12384">the #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="description" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12385">a string to be shown in `--help` output
|
|
after the list of options, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_option_context_parameter_string" c:identifier="g_application_set_option_context_parameter_string" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12396">Sets the parameter string to be used by the commandline handling of @application.
|
|
|
|
This function registers the argument to be passed to g_option_context_new()
|
|
when the internal #GOptionContext of @application is created.
|
|
|
|
See g_option_context_new() for more information about @parameter_string.</doc>
|
|
<source-position filename="gapplication.h" line="180"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12398">the #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="parameter_string" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12399">a string which is displayed
|
|
in the first line of `--help` output, after the usage summary `programname [OPTION...]`.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_option_context_summary" c:identifier="g_application_set_option_context_summary" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12413">Adds a summary to the @application option context.
|
|
|
|
See g_option_context_set_summary() for more information.</doc>
|
|
<source-position filename="gapplication.h" line="183"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12415">the #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="summary" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12416">a string to be shown in `--help` output
|
|
before the list of options, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_resource_base_path" c:identifier="g_application_set_resource_base_path" version="2.42">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12427">Sets (or unsets) the base resource path of @application.
|
|
|
|
The path is used to automatically load various [application
|
|
resources][gresource] such as menu layouts and action descriptions.
|
|
The various types of resources will be found at fixed names relative
|
|
to the given base path.
|
|
|
|
By default, the resource base path is determined from the application
|
|
ID by prefixing '/' and replacing each '.' with '/'. This is done at
|
|
the time that the #GApplication object is constructed. Changes to
|
|
the application ID after that point will not have an impact on the
|
|
resource base path.
|
|
|
|
As an example, if the application has an ID of "org.example.app" then
|
|
the default resource base path will be "/org/example/app". If this
|
|
is a #GtkApplication (and you have not manually changed the path)
|
|
then Gtk will then search for the menus of the application at
|
|
"/org/example/app/gtk/menus.ui".
|
|
|
|
See #GResource for more information about adding resources to your
|
|
application.
|
|
|
|
You can disable automatic resource loading functionality by setting
|
|
the path to %NULL.
|
|
|
|
Changing the resource base path once the application is running is
|
|
not recommended. The point at which the resource path is consulted
|
|
for forming paths for various purposes is unspecified. When writing
|
|
a sub-class of #GApplication you should either set the
|
|
#GApplication:resource-base-path property at construction time, or call
|
|
this function during the instance initialization. Alternatively, you
|
|
can call this function in the #GApplicationClass.startup virtual function,
|
|
before chaining up to the parent implementation.</doc>
|
|
<source-position filename="gapplication.h" line="157"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12429">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="resource_path" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12430">the resource path to use</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unbind_busy_property" c:identifier="g_application_unbind_busy_property" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12470">Destroys a binding between @property and the busy state of
|
|
@application that was previously created with
|
|
g_application_bind_busy_property().</doc>
|
|
<source-position filename="gapplication.h" line="246"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12472">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12473">a #GObject</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="property" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12474">the name of a boolean property of @object</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmark_busy" c:identifier="g_application_unmark_busy" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12484">Decreases the busy count of @application.
|
|
|
|
When the busy count reaches zero, the new state will be propagated
|
|
to other processes.
|
|
|
|
This function must only be called to cancel the effect of a previous
|
|
call to g_application_mark_busy().</doc>
|
|
<source-position filename="gapplication.h" line="228"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12486">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="withdraw_notification" c:identifier="g_application_withdraw_notification" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12500">Withdraws a notification that was sent with
|
|
g_application_send_notification().
|
|
|
|
This call does nothing if a notification with @id doesn't exist or
|
|
the notification was never sent.
|
|
|
|
This function works even for notifications sent in previous
|
|
executions of this application, as long @id is the same as it was for
|
|
the sent notification.
|
|
|
|
Note that notifications are dismissed when the user clicks on one
|
|
of the buttons in a notification or triggers its default action, so
|
|
there is no need to explicitly withdraw the notification in that case.</doc>
|
|
<source-position filename="gapplication.h" line="237"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12502">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</instance-parameter>
|
|
<parameter name="id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12503">id of a previously sent notification</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="action-group" readable="0" writable="1" transfer-ownership="none">
|
|
<type name="ActionGroup"/>
|
|
</property>
|
|
<property name="application-id" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="flags" writable="1" transfer-ownership="none">
|
|
<type name="ApplicationFlags"/>
|
|
</property>
|
|
<property name="inactivity-timeout" writable="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="is-busy" version="2.44" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="400">Whether the application is currently marked as busy through
|
|
g_application_mark_busy() or g_application_bind_busy_property().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-registered" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-remote" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="resource-base-path" writable="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="ApplicationPrivate" c:type="GApplicationPrivate*"/>
|
|
</field>
|
|
<glib:signal name="activate" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="276">The ::activate signal is emitted on the primary instance when an
|
|
activation occurs. See g_application_activate().</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="command-line" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="285">The ::command-line signal is emitted on the primary instance when
|
|
a commandline is not handled locally. See g_application_run() and
|
|
the #GApplicationCommandLine documentation for more information.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="295">An integer that is set as the exit status for the calling
|
|
process. See g_application_command_line_set_exit_status().</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="command_line" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="288">a #GApplicationCommandLine representing the
|
|
passed commandline</doc>
|
|
<type name="ApplicationCommandLine"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="handle-local-options" when="last" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="300">The ::handle-local-options signal is emitted on the local instance
|
|
after the parsing of the commandline options has occurred.
|
|
|
|
You can add options to be recognised during commandline option
|
|
parsing using g_application_add_main_option_entries() and
|
|
g_application_add_option_group().
|
|
|
|
Signal handlers can inspect @options (along with values pointed to
|
|
from the @arg_data of an installed #GOptionEntrys) in order to
|
|
decide to perform certain actions, including direct local handling
|
|
(which may be useful for options like --version).
|
|
|
|
In the event that the application is marked
|
|
%G_APPLICATION_HANDLES_COMMAND_LINE the "normal processing" will
|
|
send the @options dictionary to the primary instance where it can be
|
|
read with g_application_command_line_get_options_dict(). The signal
|
|
handler can modify the dictionary before returning, and the
|
|
modified dictionary will be sent.
|
|
|
|
In the event that %G_APPLICATION_HANDLES_COMMAND_LINE is not set,
|
|
"normal processing" will treat the remaining uncollected command
|
|
line arguments as filenames or URIs. If there are no arguments,
|
|
the application is activated by g_application_activate(). One or
|
|
more arguments results in a call to g_application_open().
|
|
|
|
If you want to handle the local commandline arguments for yourself
|
|
by converting them to calls to g_application_open() or
|
|
g_action_group_activate_action() then you must be sure to register
|
|
the application first. You should probably not call
|
|
g_application_activate() for yourself, however: just return -1 and
|
|
allow the default handler to do it for you. This will ensure that
|
|
the `--gapplication-service` switch works properly (i.e. no activation
|
|
in that case).
|
|
|
|
Note that this signal is emitted from the default implementation of
|
|
local_command_line(). If you override that function and don't
|
|
chain up then this signal will never be emitted.
|
|
|
|
You can override local_command_line() if you need more powerful
|
|
capabilities than what is provided here, but this should not
|
|
normally be required.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="347">an exit code. If you have handled your options and want
|
|
to exit the process, return a non-negative option, 0 for success,
|
|
and a positive value for failure. To continue, return -1 to let
|
|
the default option processing continue.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="options" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="303">the options dictionary</doc>
|
|
<type name="GLib.VariantDict"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="name-lost" when="last" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="355">The ::name-lost signal is emitted only on the registered primary instance
|
|
when a new instance has taken over. This can only happen if the application
|
|
is using the %G_APPLICATION_ALLOW_REPLACEMENT flag.
|
|
|
|
The default handler for this signal calls g_application_quit().</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="365">%TRUE if the signal has been handled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="open" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="370">The ::open signal is emitted on the primary instance when there are
|
|
files to open. See g_application_open() for more information.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="373">an array of #GFiles</doc>
|
|
<array length="1" zero-terminated="0" c:type="gpointer">
|
|
<type name="File"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="374">the length of @files</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="hint" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="375">a hint provided by the calling instance</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="shutdown" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="382">The ::shutdown signal is emitted only on the registered primary instance
|
|
immediately after the main loop terminates.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="startup" when="first">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="391">The ::startup signal is emitted on the primary instance immediately
|
|
after registration. See g_application_register().</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="ApplicationClass" c:type="GApplicationClass" glib:is-gtype-struct-for="Application" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="410">Virtual function table for #GApplication.</doc>
|
|
<source-position filename="gapplication.h" line="119"/>
|
|
<field name="parent_class" readable="0" private="1">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="startup">
|
|
<callback name="startup">
|
|
<source-position filename="gapplication.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="activate">
|
|
<callback name="activate">
|
|
<source-position filename="gapplication.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11397">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="open">
|
|
<callback name="open">
|
|
<source-position filename="gapplication.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12073">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12074">an array of #GFiles to open</doc>
|
|
<array length="2" zero-terminated="0" c:type="GFile**">
|
|
<type name="File" c:type="GFile*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12075">the length of the @files array</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="hint" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12076">a hint (or ""), but never %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="command_line">
|
|
<callback name="command_line">
|
|
<source-position filename="gapplication.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="command_line" transfer-ownership="none">
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="local_command_line">
|
|
<callback name="local_command_line">
|
|
<source-position filename="gapplication.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="90">%TRUE if the commandline has been completely handled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="75">a #GApplication</doc>
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="arguments" direction="inout" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="76">array of command line arguments</doc>
|
|
<array c:type="gchar***">
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="exit_status" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gapplication.h" line="77">exit status to fill after processing the command line.</doc>
|
|
<type name="gint" c:type="int*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="before_emit">
|
|
<callback name="before_emit">
|
|
<source-position filename="gapplication.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="after_emit">
|
|
<callback name="after_emit">
|
|
<source-position filename="gapplication.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="add_platform_data">
|
|
<callback name="add_platform_data">
|
|
<source-position filename="gapplication.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="builder" transfer-ownership="none">
|
|
<type name="GLib.VariantBuilder" c:type="GVariantBuilder*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="quit_mainloop">
|
|
<callback name="quit_mainloop">
|
|
<source-position filename="gapplication.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="run_mainloop">
|
|
<callback name="run_mainloop">
|
|
<source-position filename="gapplication.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="shutdown">
|
|
<callback name="shutdown">
|
|
<source-position filename="gapplication.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="dbus_register">
|
|
<callback name="dbus_register" throws="1">
|
|
<source-position filename="gapplication.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="dbus_unregister">
|
|
<callback name="dbus_unregister">
|
|
<source-position filename="gapplication.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handle_local_options">
|
|
<callback name="handle_local_options">
|
|
<source-position filename="gapplication.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
<parameter name="options" transfer-ownership="none">
|
|
<type name="GLib.VariantDict" c:type="GVariantDict*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="name_lost">
|
|
<callback name="name_lost">
|
|
<source-position filename="gapplication.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="application" transfer-ownership="none">
|
|
<type name="Application" c:type="GApplication*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="7">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<class name="ApplicationCommandLine" c:symbol-prefix="application_command_line" c:type="GApplicationCommandLine" parent="GObject.Object" glib:type-name="GApplicationCommandLine" glib:get-type="g_application_command_line_get_type" glib:type-struct="ApplicationCommandLineClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4801">#GApplicationCommandLine represents a command-line invocation of
|
|
an application. It is created by #GApplication and emitted
|
|
in the #GApplication::command-line signal and virtual function.
|
|
|
|
The class contains the list of arguments that the program was invoked
|
|
with. It is also possible to query if the commandline invocation was
|
|
local (ie: the current process is running in direct response to the
|
|
invocation) or remote (ie: some other process forwarded the
|
|
commandline to this process).
|
|
|
|
The GApplicationCommandLine object can provide the @argc and @argv
|
|
parameters for use with the #GOptionContext command-line parsing API,
|
|
with the g_application_command_line_get_arguments() function. See
|
|
[gapplication-example-cmdline3.c][gapplication-example-cmdline3]
|
|
for an example.
|
|
|
|
The exit status of the originally-invoked process may be set and
|
|
messages can be printed to stdout or stderr of that process. The
|
|
lifecycle of the originally-invoked process is tied to the lifecycle
|
|
of this object (ie: the process exits when the last reference is
|
|
dropped).
|
|
|
|
The main use for #GApplicationCommandLine (and the
|
|
#GApplication::command-line signal) is 'Emacs server' like use cases:
|
|
You can set the `EDITOR` environment variable to have e.g. git use
|
|
your favourite editor to edit commit messages, and if you already
|
|
have an instance of the editor running, the editing will happen
|
|
in the running instance, instead of opening a new one. An important
|
|
aspect of this use case is that the process that gets started by git
|
|
does not return until the editing is done.
|
|
|
|
Normally, the commandline is completely handled in the
|
|
#GApplication::command-line handler. The launching instance exits
|
|
once the signal handler in the primary instance has returned, and
|
|
the return value of the signal handler becomes the exit status
|
|
of the launching instance.
|
|
|[<!-- language="C" -->
|
|
static int
|
|
command_line (GApplication *application,
|
|
GApplicationCommandLine *cmdline)
|
|
{
|
|
gchar **argv;
|
|
gint argc;
|
|
gint i;
|
|
|
|
argv = g_application_command_line_get_arguments (cmdline, &argc);
|
|
|
|
g_application_command_line_print (cmdline,
|
|
"This text is written back\n"
|
|
"to stdout of the caller\n");
|
|
|
|
for (i = 0; i < argc; i++)
|
|
g_print ("argument %d: %s\n", i, argv[i]);
|
|
|
|
g_strfreev (argv);
|
|
|
|
return 0;
|
|
}
|
|
]|
|
|
The complete example can be found here:
|
|
[gapplication-example-cmdline.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline.c)
|
|
|
|
In more complicated cases, the handling of the comandline can be
|
|
split between the launcher and the primary instance.
|
|
|[<!-- language="C" -->
|
|
static gboolean
|
|
test_local_cmdline (GApplication *application,
|
|
gchar ***arguments,
|
|
gint *exit_status)
|
|
{
|
|
gint i, j;
|
|
gchar **argv;
|
|
|
|
argv = *arguments;
|
|
|
|
i = 1;
|
|
while (argv[i])
|
|
{
|
|
if (g_str_has_prefix (argv[i], "--local-"))
|
|
{
|
|
g_print ("handling argument %s locally\n", argv[i]);
|
|
g_free (argv[i]);
|
|
for (j = i; argv[j]; j++)
|
|
argv[j] = argv[j + 1];
|
|
}
|
|
else
|
|
{
|
|
g_print ("not handling argument %s locally\n", argv[i]);
|
|
i++;
|
|
}
|
|
}
|
|
|
|
*exit_status = 0;
|
|
|
|
return FALSE;
|
|
}
|
|
|
|
static void
|
|
test_application_class_init (TestApplicationClass *class)
|
|
{
|
|
G_APPLICATION_CLASS (class)->local_command_line = test_local_cmdline;
|
|
|
|
...
|
|
}
|
|
]|
|
|
In this example of split commandline handling, options that start
|
|
with `--local-` are handled locally, all other options are passed
|
|
to the #GApplication::command-line handler which runs in the primary
|
|
instance.
|
|
|
|
The complete example can be found here:
|
|
[gapplication-example-cmdline2.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline2.c)
|
|
|
|
If handling the commandline requires a lot of work, it may
|
|
be better to defer it.
|
|
|[<!-- language="C" -->
|
|
static gboolean
|
|
my_cmdline_handler (gpointer data)
|
|
{
|
|
GApplicationCommandLine *cmdline = data;
|
|
|
|
// do the heavy lifting in an idle
|
|
|
|
g_application_command_line_set_exit_status (cmdline, 0);
|
|
g_object_unref (cmdline); // this releases the application
|
|
|
|
return G_SOURCE_REMOVE;
|
|
}
|
|
|
|
static int
|
|
command_line (GApplication *application,
|
|
GApplicationCommandLine *cmdline)
|
|
{
|
|
// keep the application running until we are done with this commandline
|
|
g_application_hold (application);
|
|
|
|
g_object_set_data_full (G_OBJECT (cmdline),
|
|
"application", application,
|
|
(GDestroyNotify)g_application_release);
|
|
|
|
g_object_ref (cmdline);
|
|
g_idle_add (my_cmdline_handler, cmdline);
|
|
|
|
return 0;
|
|
}
|
|
]|
|
|
In this example the commandline is not completely handled before
|
|
the #GApplication::command-line handler returns. Instead, we keep
|
|
a reference to the #GApplicationCommandLine object and handle it
|
|
later (in this example, in an idle). Note that it is necessary to
|
|
hold the application until you are done with the commandline.
|
|
|
|
The complete example can be found here:
|
|
[gapplication-example-cmdline3.c](https://git.gnome.org/browse/glib/tree/gio/tests/gapplication-example-cmdline3.c)</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="70"/>
|
|
<virtual-method name="get_stdin" invoker="get_stdin" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11700">Gets the stdin of the invoking process.
|
|
|
|
The #GInputStream can be used to read data passed to the standard
|
|
input of the invoking process.
|
|
This doesn't work on all platforms. Presently, it is only available
|
|
on UNIX when using a DBus daemon capable of passing file descriptors.
|
|
If stdin is not available then %NULL will be returned. In the
|
|
future, support may be expanded to other platforms.
|
|
|
|
You must only call this function once per commandline invocation.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11715">a #GInputStream for stdin</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11702">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="print_literal">
|
|
<source-position filename="gapplicationcommandline.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="printerr_literal">
|
|
<source-position filename="gapplicationcommandline.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="create_file_for_arg" c:identifier="g_application_command_line_create_file_for_arg" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11556">Creates a #GFile corresponding to a filename that was given as part
|
|
of the invocation of @cmdline.
|
|
|
|
This differs from g_file_new_for_commandline_arg() in that it
|
|
resolves relative pathnames using the current working directory of
|
|
the invoking process rather than the local process.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="117"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11568">a new #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11558">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="arg" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11559">an argument from @cmdline</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_arguments" c:identifier="g_application_command_line_get_arguments" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11573">Gets the list of arguments that was passed on the command line.
|
|
|
|
The strings in the array may contain non-UTF-8 data on UNIX (such as
|
|
filenames or arguments given in the system locale) but are always in
|
|
UTF-8 on Windows.
|
|
|
|
If you wish to use the return value with #GOptionContext, you must
|
|
use g_option_context_parse_strv().
|
|
|
|
The return value is %NULL-terminated and should be freed using
|
|
g_strfreev().</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="76"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11590">
|
|
the string array containing the arguments (the argv)</doc>
|
|
<array length="0" zero-terminated="0" c:type="gchar**">
|
|
<type name="filename"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11575">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="argc" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11576">the length of the arguments array, or %NULL</doc>
|
|
<type name="gint" c:type="int*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_cwd" c:identifier="g_application_command_line_get_cwd" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11596">Gets the working directory of the command line invocation.
|
|
The string may contain non-utf8 data.
|
|
|
|
It is possible that the remote application did not send a working
|
|
directory, so this may be %NULL.
|
|
|
|
The return value should not be modified or freed and is valid for as
|
|
long as @cmdline exists.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="93"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11609">the current directory, or %NULL</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11598">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_environ" c:identifier="g_application_command_line_get_environ" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11614">Gets the contents of the 'environ' variable of the command line
|
|
invocation, as would be returned by g_get_environ(), ie as a
|
|
%NULL-terminated list of strings in the form 'NAME=VALUE'.
|
|
The strings may contain non-utf8 data.
|
|
|
|
The remote application usually does not send an environment. Use
|
|
%G_APPLICATION_SEND_ENVIRONMENT to affect that. Even with this flag
|
|
set it is possible that the environment is still not available (due
|
|
to invocation messages from other applications).
|
|
|
|
The return value should not be modified or freed and is valid for as
|
|
long as @cmdline exists.
|
|
|
|
See g_application_command_line_getenv() if you are only interested
|
|
in the value of a single environment variable.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11634">
|
|
the environment strings, or %NULL if they were not sent</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="filename"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11616">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_exit_status" c:identifier="g_application_command_line_get_exit_status" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11640">Gets the exit status of @cmdline. See
|
|
g_application_command_line_set_exit_status() for more information.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11647">the exit status</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11642">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_remote" c:identifier="g_application_command_line_get_is_remote" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11652">Determines if @cmdline represents a remote invocation.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11658">%TRUE if the invocation was remote</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11654">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_options_dict" c:identifier="g_application_command_line_get_options_dict" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11663">Gets the options there were passed to g_application_command_line().
|
|
|
|
If you did not override local_command_line() then these are the same
|
|
options that were parsed according to the #GOptionEntrys added to the
|
|
application with g_application_add_main_option_entries() and possibly
|
|
modified from your GApplication::handle-local-options handler.
|
|
|
|
If no options were sent then an empty dictionary is returned so that
|
|
you don't need to check for %NULL.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11677">a #GVariantDict with the options</doc>
|
|
<type name="GLib.VariantDict" c:type="GVariantDict*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11665">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_platform_data" c:identifier="g_application_command_line_get_platform_data" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11682">Gets the platform data associated with the invocation of @cmdline.
|
|
|
|
This is a #GVariant dictionary containing information about the
|
|
context in which the invocation occurred. It typically contains
|
|
information like the current working directory and the startup
|
|
notification ID.
|
|
|
|
For local invocation, it will be %NULL.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="114"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11695">the platform data, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11684">#GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_stdin" c:identifier="g_application_command_line_get_stdin" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11700">Gets the stdin of the invoking process.
|
|
|
|
The #GInputStream can be used to read data passed to the standard
|
|
input of the invoking process.
|
|
This doesn't work on all platforms. Presently, it is only available
|
|
on UNIX when using a DBus daemon capable of passing file descriptors.
|
|
If stdin is not available then %NULL will be returned. In the
|
|
future, support may be expanded to other platforms.
|
|
|
|
You must only call this function once per commandline invocation.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11715">a #GInputStream for stdin</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11702">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="getenv" c:identifier="g_application_command_line_getenv" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11720">Gets the value of a particular environment variable of the command
|
|
line invocation, as would be returned by g_getenv(). The strings may
|
|
contain non-utf8 data.
|
|
|
|
The remote application usually does not send an environment. Use
|
|
%G_APPLICATION_SEND_ENVIRONMENT to affect that. Even with this flag
|
|
set it is possible that the environment is still not available (due
|
|
to invocation messages from other applications).
|
|
|
|
The return value should not be modified or freed and is valid for as
|
|
long as @cmdline exists.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11737">the value of the variable, or %NULL if unset or unsent</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11722">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11723">the environment variable to get</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="print" c:identifier="g_application_command_line_print" version="2.28" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11742">Formats a message and prints it using the stdout print handler in the
|
|
invoking process.
|
|
|
|
If @cmdline is a local invocation then this is exactly equivalent to
|
|
g_print(). If @cmdline is remote then this is equivalent to calling
|
|
g_print() in the invoking process.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11744">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11745">a printf-style format string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11746">arguments, as per @format</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="printerr" c:identifier="g_application_command_line_printerr" version="2.28" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11759">Formats a message and prints it using the stderr print handler in the
|
|
invoking process.
|
|
|
|
If @cmdline is a local invocation then this is exactly equivalent to
|
|
g_printerr(). If @cmdline is remote then this is equivalent to
|
|
calling g_printerr() in the invoking process.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11761">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11762">a printf-style format string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11763">arguments, as per @format</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_exit_status" c:identifier="g_application_command_line_set_exit_status" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11776">Sets the exit status that will be used when the invoking process
|
|
exits.
|
|
|
|
The return value of the #GApplication::command-line signal is
|
|
passed to this function when the handler returns. This is the usual
|
|
way of setting the exit status.
|
|
|
|
In the event that you want the remote invocation to continue running
|
|
and want to decide on the exit status in the future, you can use this
|
|
call. For the case of a remote invocation, the remote process will
|
|
typically exit when the last reference is dropped on @cmdline. The
|
|
exit status of the remote process will be equal to the last value
|
|
that was set with this function.
|
|
|
|
In the case that the commandline invocation is local, the situation
|
|
is slightly more complicated. If the commandline invocation results
|
|
in the mainloop running (ie: because the use-count of the application
|
|
increased to a non-zero value) then the application is considered to
|
|
have been 'successful' in a certain sense, and the exit status is
|
|
always zero. If the application use count is zero, though, the exit
|
|
status of the local #GApplicationCommandLine is used.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11778">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</instance-parameter>
|
|
<parameter name="exit_status" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11779">the exit status</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="arguments" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="GLib.Variant"/>
|
|
</property>
|
|
<property name="is-remote" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="options" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="GLib.Variant"/>
|
|
</property>
|
|
<property name="platform-data" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="GLib.Variant"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="ApplicationCommandLinePrivate" c:type="GApplicationCommandLinePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="ApplicationCommandLineClass" c:type="GApplicationCommandLineClass" glib:is-gtype-struct-for="ApplicationCommandLine" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="467">The #GApplicationCommandLineClass-struct
|
|
contains private data only.</doc>
|
|
<source-position filename="gapplicationcommandline.h" line="70"/>
|
|
<field name="parent_class" readable="0" private="1">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="print_literal">
|
|
<callback name="print_literal">
|
|
<source-position filename="gapplicationcommandline.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="cmdline" transfer-ownership="none">
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="printerr_literal">
|
|
<callback name="printerr_literal">
|
|
<source-position filename="gapplicationcommandline.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="cmdline" transfer-ownership="none">
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_stdin">
|
|
<callback name="get_stdin">
|
|
<source-position filename="gapplicationcommandline.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11715">a #GInputStream for stdin</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="cmdline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11702">a #GApplicationCommandLine</doc>
|
|
<type name="ApplicationCommandLine" c:type="GApplicationCommandLine*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="11">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="ApplicationCommandLinePrivate" c:type="GApplicationCommandLinePrivate" disguised="1">
|
|
<source-position filename="gapplicationcommandline.h" line="47"/>
|
|
</record>
|
|
<bitfield name="ApplicationFlags" version="2.28" glib:type-name="GApplicationFlags" glib:get-type="g_application_flags_get_type" c:type="GApplicationFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1461">Flags used to define the behaviour of a #GApplication.</doc>
|
|
<member name="flags_none" value="0" c:identifier="G_APPLICATION_FLAGS_NONE" glib:nick="flags-none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1463">Default</doc>
|
|
</member>
|
|
<member name="is_service" value="1" c:identifier="G_APPLICATION_IS_SERVICE" glib:nick="is-service">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1464">Run as a service. In this mode, registration
|
|
fails if the service is already running, and the application
|
|
will initially wait up to 10 seconds for an initial activation
|
|
message to arrive.</doc>
|
|
</member>
|
|
<member name="is_launcher" value="2" c:identifier="G_APPLICATION_IS_LAUNCHER" glib:nick="is-launcher">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1468">Don't try to become the primary instance.</doc>
|
|
</member>
|
|
<member name="handles_open" value="4" c:identifier="G_APPLICATION_HANDLES_OPEN" glib:nick="handles-open">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1469">This application handles opening files (in
|
|
the primary instance). Note that this flag only affects the default
|
|
implementation of local_command_line(), and has no effect if
|
|
%G_APPLICATION_HANDLES_COMMAND_LINE is given.
|
|
See g_application_run() for details.</doc>
|
|
</member>
|
|
<member name="handles_command_line" value="8" c:identifier="G_APPLICATION_HANDLES_COMMAND_LINE" glib:nick="handles-command-line">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1474">This application handles command line
|
|
arguments (in the primary instance). Note that this flag only affect
|
|
the default implementation of local_command_line().
|
|
See g_application_run() for details.</doc>
|
|
</member>
|
|
<member name="send_environment" value="16" c:identifier="G_APPLICATION_SEND_ENVIRONMENT" glib:nick="send-environment">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1478">Send the environment of the
|
|
launching process to the primary instance. Set this flag if your
|
|
application is expected to behave differently depending on certain
|
|
environment variables. For instance, an editor might be expected
|
|
to use the `GIT_COMMITTER_NAME` environment variable
|
|
when editing a git commit message. The environment is available
|
|
to the #GApplication::command-line signal handler, via
|
|
g_application_command_line_getenv().</doc>
|
|
</member>
|
|
<member name="non_unique" value="32" c:identifier="G_APPLICATION_NON_UNIQUE" glib:nick="non-unique">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1486">Make no attempts to do any of the typical
|
|
single-instance application negotiation, even if the application
|
|
ID is given. The application neither attempts to become the
|
|
owner of the application ID nor does it check if an existing
|
|
owner already exists. Everything occurs in the local process.
|
|
Since: 2.30.</doc>
|
|
</member>
|
|
<member name="can_override_app_id" value="64" c:identifier="G_APPLICATION_CAN_OVERRIDE_APP_ID" glib:nick="can-override-app-id">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1492">Allow users to override the
|
|
application ID from the command line with `--gapplication-app-id`.
|
|
Since: 2.48</doc>
|
|
</member>
|
|
<member name="allow_replacement" value="128" c:identifier="G_APPLICATION_ALLOW_REPLACEMENT" glib:nick="allow-replacement">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1495">Allow another instance to take over
|
|
the bus name. Since: 2.60</doc>
|
|
</member>
|
|
<member name="replace" value="256" c:identifier="G_APPLICATION_REPLACE" glib:nick="replace">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1497">Take over from another instance. This flag is
|
|
usually set by passing `--gapplication-replace` on the commandline.
|
|
Since: 2.60</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="ApplicationPrivate" c:type="GApplicationPrivate" disguised="1">
|
|
<source-position filename="gapplication.h" line="41"/>
|
|
</record>
|
|
<bitfield name="AskPasswordFlags" glib:type-name="GAskPasswordFlags" glib:get-type="g_ask_password_flags_get_type" c:type="GAskPasswordFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="580">#GAskPasswordFlags are used to request specific information from the
|
|
user, or to notify the user of their choices in an authentication
|
|
situation.</doc>
|
|
<member name="need_password" value="1" c:identifier="G_ASK_PASSWORD_NEED_PASSWORD" glib:nick="need-password">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="582">operation requires a password.</doc>
|
|
</member>
|
|
<member name="need_username" value="2" c:identifier="G_ASK_PASSWORD_NEED_USERNAME" glib:nick="need-username">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="583">operation requires a username.</doc>
|
|
</member>
|
|
<member name="need_domain" value="4" c:identifier="G_ASK_PASSWORD_NEED_DOMAIN" glib:nick="need-domain">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="584">operation requires a domain.</doc>
|
|
</member>
|
|
<member name="saving_supported" value="8" c:identifier="G_ASK_PASSWORD_SAVING_SUPPORTED" glib:nick="saving-supported">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="585">operation supports saving settings.</doc>
|
|
</member>
|
|
<member name="anonymous_supported" value="16" c:identifier="G_ASK_PASSWORD_ANONYMOUS_SUPPORTED" glib:nick="anonymous-supported">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="586">operation supports anonymous users.</doc>
|
|
</member>
|
|
<member name="tcrypt" value="32" c:identifier="G_ASK_PASSWORD_TCRYPT" glib:nick="tcrypt">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="587">operation takes TCRYPT parameters (Since: 2.58)</doc>
|
|
</member>
|
|
</bitfield>
|
|
<interface name="AsyncInitable" c:symbol-prefix="async_initable" c:type="GAsyncInitable" version="2.22" glib:type-name="GAsyncInitable" glib:get-type="g_async_initable_get_type" glib:type-struct="AsyncInitableIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4965">This is the asynchronous version of #GInitable; it behaves the same
|
|
in all ways except that initialization is asynchronous. For more details
|
|
see the descriptions on #GInitable.
|
|
|
|
A class may implement both the #GInitable and #GAsyncInitable interfaces.
|
|
|
|
Users of objects implementing this are not intended to use the interface
|
|
method directly; instead it will be used automatically in various ways.
|
|
For C applications you generally just call g_async_initable_new_async()
|
|
directly, or indirectly via a foo_thing_new_async() wrapper. This will call
|
|
g_async_initable_init_async() under the cover, calling back with %NULL and
|
|
a set %GError on failure.
|
|
|
|
A typical implementation might look something like this:
|
|
|
|
|[<!-- language="C" -->
|
|
enum {
|
|
NOT_INITIALIZED,
|
|
INITIALIZING,
|
|
INITIALIZED
|
|
};
|
|
|
|
static void
|
|
_foo_ready_cb (Foo *self)
|
|
{
|
|
GList *l;
|
|
|
|
self->priv->state = INITIALIZED;
|
|
|
|
for (l = self->priv->init_results; l != NULL; l = l->next)
|
|
{
|
|
GTask *task = l->data;
|
|
|
|
if (self->priv->success)
|
|
g_task_return_boolean (task, TRUE);
|
|
else
|
|
g_task_return_new_error (task, ...);
|
|
g_object_unref (task);
|
|
}
|
|
|
|
g_list_free (self->priv->init_results);
|
|
self->priv->init_results = NULL;
|
|
}
|
|
|
|
static void
|
|
foo_init_async (GAsyncInitable *initable,
|
|
int io_priority,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
Foo *self = FOO (initable);
|
|
GTask *task;
|
|
|
|
task = g_task_new (initable, cancellable, callback, user_data);
|
|
|
|
switch (self->priv->state)
|
|
{
|
|
case NOT_INITIALIZED:
|
|
_foo_get_ready (self);
|
|
self->priv->init_results = g_list_append (self->priv->init_results,
|
|
task);
|
|
self->priv->state = INITIALIZING;
|
|
break;
|
|
case INITIALIZING:
|
|
self->priv->init_results = g_list_append (self->priv->init_results,
|
|
task);
|
|
break;
|
|
case INITIALIZED:
|
|
if (!self->priv->success)
|
|
g_task_return_new_error (task, ...);
|
|
else
|
|
g_task_return_boolean (task, TRUE);
|
|
g_object_unref (task);
|
|
break;
|
|
}
|
|
}
|
|
|
|
static gboolean
|
|
foo_init_finish (GAsyncInitable *initable,
|
|
GAsyncResult *result,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (g_task_is_valid (result, initable), FALSE);
|
|
|
|
return g_task_propagate_boolean (G_TASK (result), error);
|
|
}
|
|
|
|
static void
|
|
foo_async_initable_iface_init (gpointer g_iface,
|
|
gpointer data)
|
|
{
|
|
GAsyncInitableIface *iface = g_iface;
|
|
|
|
iface->init_async = foo_init_async;
|
|
iface->init_finish = foo_init_finish;
|
|
}
|
|
]|</doc>
|
|
<source-position filename="gasyncinitable.h" line="73"/>
|
|
<function name="new_async" c:identifier="g_async_initable_new_async" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12588">Helper function for constructing #GAsyncInitable object. This is
|
|
similar to g_object_new() but also initializes the object asynchronously.
|
|
|
|
When the initialization is finished, @callback will be called. You can
|
|
then call g_async_initable_new_finish() to get the new object and check
|
|
for any errors.</doc>
|
|
<source-position filename="gasyncinitable.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12590">a #GType supporting #GAsyncInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12591">the [I/O priority][io-priority] of the operation</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12592">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12593">a #GAsyncReadyCallback to call when the initialization is
|
|
finished</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12595">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="first_property_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12596">the name of the first property, or %NULL if no
|
|
properties</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12598">the value of the first property, followed by other property
|
|
value pairs, and ended by %NULL.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_valist_async" c:identifier="g_async_initable_new_valist_async" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12627">Helper function for constructing #GAsyncInitable object. This is
|
|
similar to g_object_new_valist() but also initializes the object
|
|
asynchronously.
|
|
|
|
When the initialization is finished, @callback will be called. You can
|
|
then call g_async_initable_new_finish() to get the new object and check
|
|
for any errors.</doc>
|
|
<source-position filename="gasyncinitable.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12629">a #GType supporting #GAsyncInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="first_property_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12630">the name of the first property, followed by
|
|
the value, and other property value pairs, and ended by %NULL.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="var_args" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12632">The var args list generated from @first_property_name.</doc>
|
|
<type name="va_list" c:type="va_list"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12633">the [I/O priority][io-priority] of the operation</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12634">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12635">a #GAsyncReadyCallback to call when the initialization is
|
|
finished</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12637">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="newv_async" c:identifier="g_async_initable_newv_async" version="2.22" deprecated="1" deprecated-version="2.54">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12651">Helper function for constructing #GAsyncInitable object. This is
|
|
similar to g_object_newv() but also initializes the object asynchronously.
|
|
|
|
When the initialization is finished, @callback will be called. You can
|
|
then call g_async_initable_new_finish() to get the new object and check
|
|
for any errors.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
|
g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
|
|
<source-position filename="gasyncinitable.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12653">a #GType supporting #GAsyncInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="n_parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12654">the number of parameters in @parameters</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12655">the parameters to use to construct the object</doc>
|
|
<type name="GObject.Parameter" c:type="GParameter*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12656">the [I/O priority][io-priority] of the operation</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12657">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12658">a #GAsyncReadyCallback to call when the initialization is
|
|
finished</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12660">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="init_async" invoker="init_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12523">Starts asynchronous initialization of the object implementing the
|
|
interface. This must be done before any real use of the object after
|
|
initial construction. If the object also implements #GInitable you can
|
|
optionally call g_initable_init() instead.
|
|
|
|
This method is intended for language bindings. If writing in C,
|
|
g_async_initable_new_async() should typically be used instead.
|
|
|
|
When the initialization is finished, @callback will be called. You can
|
|
then call g_async_initable_init_finish() to get the result of the
|
|
initialization.
|
|
|
|
Implementations may also support cancellation. If @cancellable is not
|
|
%NULL, then initialization can be cancelled by triggering the cancellable
|
|
object from another thread. If the operation was cancelled, the error
|
|
%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL, and
|
|
the object doesn't support cancellable initialization, the error
|
|
%G_IO_ERROR_NOT_SUPPORTED will be returned.
|
|
|
|
As with #GInitable, if the object is not initialized, or initialization
|
|
returns with an error, then all operations on the object except
|
|
g_object_ref() and g_object_unref() are considered to be invalid, and
|
|
have undefined behaviour. They will often fail with g_critical() or
|
|
g_warning(), but this must not be relied on.
|
|
|
|
Callers should not assume that a class which implements #GAsyncInitable can
|
|
be initialized multiple times; for more information, see g_initable_init().
|
|
If a class explicitly supports being initialized multiple times,
|
|
implementation requires yielding all subsequent calls to init_async() on the
|
|
results of the first call.
|
|
|
|
For classes that also support the #GInitable interface, the default
|
|
implementation of this method will run the g_initable_init() function
|
|
in a thread, so if you want to support asynchronous initialization via
|
|
threads, just implement the #GAsyncInitable interface without overriding
|
|
any interface methods.</doc>
|
|
<source-position filename="gasyncinitable.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12525">a #GAsyncInitable.</doc>
|
|
<type name="AsyncInitable" c:type="GAsyncInitable*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12526">the [I/O priority][io-priority] of the operation</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12527">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12528">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12529">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="init_finish" invoker="init_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12572">Finishes asynchronous initialization and returns the result.
|
|
See g_async_initable_init_async().</doc>
|
|
<source-position filename="gasyncinitable.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12582">%TRUE if successful. If an error has occurred, this function
|
|
will return %FALSE and set @error appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12574">a #GAsyncInitable.</doc>
|
|
<type name="AsyncInitable" c:type="GAsyncInitable*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12575">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="init_async" c:identifier="g_async_initable_init_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12523">Starts asynchronous initialization of the object implementing the
|
|
interface. This must be done before any real use of the object after
|
|
initial construction. If the object also implements #GInitable you can
|
|
optionally call g_initable_init() instead.
|
|
|
|
This method is intended for language bindings. If writing in C,
|
|
g_async_initable_new_async() should typically be used instead.
|
|
|
|
When the initialization is finished, @callback will be called. You can
|
|
then call g_async_initable_init_finish() to get the result of the
|
|
initialization.
|
|
|
|
Implementations may also support cancellation. If @cancellable is not
|
|
%NULL, then initialization can be cancelled by triggering the cancellable
|
|
object from another thread. If the operation was cancelled, the error
|
|
%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL, and
|
|
the object doesn't support cancellable initialization, the error
|
|
%G_IO_ERROR_NOT_SUPPORTED will be returned.
|
|
|
|
As with #GInitable, if the object is not initialized, or initialization
|
|
returns with an error, then all operations on the object except
|
|
g_object_ref() and g_object_unref() are considered to be invalid, and
|
|
have undefined behaviour. They will often fail with g_critical() or
|
|
g_warning(), but this must not be relied on.
|
|
|
|
Callers should not assume that a class which implements #GAsyncInitable can
|
|
be initialized multiple times; for more information, see g_initable_init().
|
|
If a class explicitly supports being initialized multiple times,
|
|
implementation requires yielding all subsequent calls to init_async() on the
|
|
results of the first call.
|
|
|
|
For classes that also support the #GInitable interface, the default
|
|
implementation of this method will run the g_initable_init() function
|
|
in a thread, so if you want to support asynchronous initialization via
|
|
threads, just implement the #GAsyncInitable interface without overriding
|
|
any interface methods.</doc>
|
|
<source-position filename="gasyncinitable.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12525">a #GAsyncInitable.</doc>
|
|
<type name="AsyncInitable" c:type="GAsyncInitable*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12526">the [I/O priority][io-priority] of the operation</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12527">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12528">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12529">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init_finish" c:identifier="g_async_initable_init_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12572">Finishes asynchronous initialization and returns the result.
|
|
See g_async_initable_init_async().</doc>
|
|
<source-position filename="gasyncinitable.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12582">%TRUE if successful. If an error has occurred, this function
|
|
will return %FALSE and set @error appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12574">a #GAsyncInitable.</doc>
|
|
<type name="AsyncInitable" c:type="GAsyncInitable*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12575">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="new_finish" c:identifier="g_async_initable_new_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12612">Finishes the async construction for the various g_async_initable_new
|
|
calls, returning the created object or %NULL on error.</doc>
|
|
<source-position filename="gasyncinitable.h" line="121"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12621">a newly created #GObject,
|
|
or %NULL on error. Free with g_object_unref().</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12614">the #GAsyncInitable from the callback</doc>
|
|
<type name="AsyncInitable" c:type="GAsyncInitable*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12615">the #GAsyncResult from the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="AsyncInitableIface" c:type="GAsyncInitableIface" glib:is-gtype-struct-for="AsyncInitable" version="2.22">
|
|
<doc xml:space="preserve" filename="gasyncinitable.h" line="48">Provides an interface for asynchronous initializing object such that
|
|
initialization may fail.</doc>
|
|
<source-position filename="gasyncinitable.h" line="73"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gasyncinitable.h" line="50">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="init_async">
|
|
<callback name="init_async">
|
|
<source-position filename="gasyncinitable.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12525">a #GAsyncInitable.</doc>
|
|
<type name="AsyncInitable" c:type="GAsyncInitable*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12526">the [I/O priority][io-priority] of the operation</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12527">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12528">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12529">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="init_finish">
|
|
<callback name="init_finish" throws="1">
|
|
<source-position filename="gasyncinitable.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12582">%TRUE if successful. If an error has occurred, this function
|
|
will return %FALSE and set @error appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12574">a #GAsyncInitable.</doc>
|
|
<type name="AsyncInitable" c:type="GAsyncInitable*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12575">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<callback name="AsyncReadyCallback" c:type="GAsyncReadyCallback">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="260">Type definition for a function that will be called back when an asynchronous
|
|
operation within GIO has been completed. #GAsyncReadyCallback
|
|
callbacks from #GTask are guaranteed to be invoked in a later
|
|
iteration of the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
where the #GTask was created. All other users of
|
|
#GAsyncReadyCallback must likewise call it asynchronously in a
|
|
later iteration of the main context.</doc>
|
|
<source-position filename="giotypes.h" line="275"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="262">the object the asynchronous operation was started with.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="263">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="264">user data passed to the callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<interface name="AsyncResult" c:symbol-prefix="async_result" c:type="GAsyncResult" glib:type-name="GAsyncResult" glib:get-type="g_async_result_get_type" glib:type-struct="AsyncResultIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5072">Provides a base class for implementing asynchronous function results.
|
|
|
|
Asynchronous operations are broken up into two separate operations
|
|
which are chained together by a #GAsyncReadyCallback. To begin
|
|
an asynchronous operation, provide a #GAsyncReadyCallback to the
|
|
asynchronous function. This callback will be triggered when the
|
|
operation has completed, and must be run in a later iteration of
|
|
the [thread-default main context][g-main-context-push-thread-default]
|
|
from where the operation was initiated. It will be passed a
|
|
#GAsyncResult instance filled with the details of the operation's
|
|
success or failure, the object the asynchronous function was
|
|
started for and any error codes returned. The asynchronous callback
|
|
function is then expected to call the corresponding "_finish()"
|
|
function, passing the object the function was called for, the
|
|
#GAsyncResult instance, and (optionally) an @error to grab any
|
|
error conditions that may have occurred.
|
|
|
|
The "_finish()" function for an operation takes the generic result
|
|
(of type #GAsyncResult) and returns the specific result that the
|
|
operation in question yields (e.g. a #GFileEnumerator for a
|
|
"enumerate children" operation). If the result or error status of the
|
|
operation is not needed, there is no need to call the "_finish()"
|
|
function; GIO will take care of cleaning up the result and error
|
|
information after the #GAsyncReadyCallback returns. You can pass
|
|
%NULL for the #GAsyncReadyCallback if you don't need to take any
|
|
action at all after the operation completes. Applications may also
|
|
take a reference to the #GAsyncResult and call "_finish()" later;
|
|
however, the "_finish()" function may be called at most once.
|
|
|
|
Example of a typical asynchronous operation flow:
|
|
|[<!-- language="C" -->
|
|
void _theoretical_frobnitz_async (Theoretical *t,
|
|
GCancellable *c,
|
|
GAsyncReadyCallback cb,
|
|
gpointer u);
|
|
|
|
gboolean _theoretical_frobnitz_finish (Theoretical *t,
|
|
GAsyncResult *res,
|
|
GError **e);
|
|
|
|
static void
|
|
frobnitz_result_func (GObject *source_object,
|
|
GAsyncResult *res,
|
|
gpointer user_data)
|
|
{
|
|
gboolean success = FALSE;
|
|
|
|
success = _theoretical_frobnitz_finish (source_object, res, NULL);
|
|
|
|
if (success)
|
|
g_printf ("Hurray!\n");
|
|
else
|
|
g_printf ("Uh oh!\n");
|
|
|
|
...
|
|
|
|
}
|
|
|
|
int main (int argc, void *argv[])
|
|
{
|
|
...
|
|
|
|
_theoretical_frobnitz_async (theoretical_data,
|
|
NULL,
|
|
frobnitz_result_func,
|
|
NULL);
|
|
|
|
...
|
|
}
|
|
]|
|
|
|
|
The callback for an asynchronous operation is called only once, and is
|
|
always called, even in the case of a cancelled operation. On cancellation
|
|
the result is a %G_IO_ERROR_CANCELLED error.
|
|
|
|
## I/O Priority # {#io-priority}
|
|
|
|
Many I/O-related asynchronous operations have a priority parameter,
|
|
which is used in certain cases to determine the order in which
|
|
operations are executed. They are not used to determine system-wide
|
|
I/O scheduling. Priorities are integers, with lower numbers indicating
|
|
higher priority. It is recommended to choose priorities between
|
|
%G_PRIORITY_LOW and %G_PRIORITY_HIGH, with %G_PRIORITY_DEFAULT
|
|
as a default.</doc>
|
|
<source-position filename="gasyncresult.h" line="66"/>
|
|
<virtual-method name="get_source_object" invoker="get_source_object">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12675">Gets the source object from a #GAsyncResult.</doc>
|
|
<source-position filename="gasyncresult.h" line="62"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12681">a new reference to the source
|
|
object for the @res, or %NULL if there is none.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12677">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_user_data" invoker="get_user_data">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12686">Gets the user data from a #GAsyncResult.</doc>
|
|
<source-position filename="gasyncresult.h" line="61"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12692">the user data for @res.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12688">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_tagged" invoker="is_tagged" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12696">Checks if @res has the given @source_tag (generally a function
|
|
pointer indicating the function @res was created by).</doc>
|
|
<source-position filename="gasyncresult.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12704">%TRUE if @res has the indicated @source_tag, %FALSE if
|
|
not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12698">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12699">an application-defined tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_source_object" c:identifier="g_async_result_get_source_object">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12675">Gets the source object from a #GAsyncResult.</doc>
|
|
<source-position filename="gasyncresult.h" line="74"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12681">a new reference to the source
|
|
object for the @res, or %NULL if there is none.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12677">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_user_data" c:identifier="g_async_result_get_user_data">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12686">Gets the user data from a #GAsyncResult.</doc>
|
|
<source-position filename="gasyncresult.h" line="72"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12692">the user data for @res.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12688">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_tagged" c:identifier="g_async_result_is_tagged" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12696">Checks if @res has the given @source_tag (generally a function
|
|
pointer indicating the function @res was created by).</doc>
|
|
<source-position filename="gasyncresult.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12704">%TRUE if @res has the indicated @source_tag, %FALSE if
|
|
not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12698">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12699">an application-defined tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="legacy_propagate_error" c:identifier="g_async_result_legacy_propagate_error" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12710">If @res is a #GSimpleAsyncResult, this is equivalent to
|
|
g_simple_async_result_propagate_error(). Otherwise it returns
|
|
%FALSE.
|
|
|
|
This can be used for legacy error handling in async *_finish()
|
|
wrapper functions that traditionally handled #GSimpleAsyncResult
|
|
error returns themselves rather than calling into the virtual method.
|
|
This should not be used in new code; #GAsyncResult errors that are
|
|
set by virtual methods should also be extracted by virtual methods,
|
|
to enable subclasses to chain up correctly.</doc>
|
|
<source-position filename="gasyncresult.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12726">%TRUE if @error is has been filled in with an error from
|
|
@res, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12712">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="AsyncResultIface" c:type="GAsyncResultIface" glib:is-gtype-struct-for="AsyncResult">
|
|
<doc xml:space="preserve" filename="gasyncresult.h" line="46">Interface definition for #GAsyncResult.</doc>
|
|
<source-position filename="gasyncresult.h" line="66"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gasyncresult.h" line="48">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_user_data">
|
|
<callback name="get_user_data">
|
|
<source-position filename="gasyncresult.h" line="61"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12692">the user data for @res.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12688">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_source_object">
|
|
<callback name="get_source_object">
|
|
<source-position filename="gasyncresult.h" line="62"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12681">a new reference to the source
|
|
object for the @res, or %NULL if there is none.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12677">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_tagged">
|
|
<callback name="is_tagged">
|
|
<source-position filename="gasyncresult.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12704">%TRUE if @res has the indicated @source_tag, %FALSE if
|
|
not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12698">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12699">an application-defined tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<function-macro name="BUFFERED_INPUT_STREAM" c:identifier="G_BUFFERED_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gbufferedinputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BUFFERED_INPUT_STREAM_CLASS" c:identifier="G_BUFFERED_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gbufferedinputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BUFFERED_INPUT_STREAM_GET_CLASS" c:identifier="G_BUFFERED_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gbufferedinputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BUFFERED_OUTPUT_STREAM" c:identifier="G_BUFFERED_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gbufferedoutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BUFFERED_OUTPUT_STREAM_CLASS" c:identifier="G_BUFFERED_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gbufferedoutputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BUFFERED_OUTPUT_STREAM_GET_CLASS" c:identifier="G_BUFFERED_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gbufferedoutputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="BYTES_ICON" c:identifier="G_BYTES_ICON" introspectable="0">
|
|
<source-position filename="gbytesicon.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="BufferedInputStream" c:symbol-prefix="buffered_input_stream" c:type="GBufferedInputStream" parent="FilterInputStream" glib:type-name="GBufferedInputStream" glib:get-type="g_buffered_input_stream_get_type" glib:type-struct="BufferedInputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5165">Buffered input stream implements #GFilterInputStream and provides
|
|
for buffered reads.
|
|
|
|
By default, #GBufferedInputStream's buffer size is set at 4 kilobytes.
|
|
|
|
To create a buffered input stream, use g_buffered_input_stream_new(),
|
|
or g_buffered_input_stream_new_sized() to specify the buffer's size at
|
|
construction.
|
|
|
|
To get the size of a buffer within a buffered input stream, use
|
|
g_buffered_input_stream_get_buffer_size(). To change the size of a
|
|
buffered input stream's buffer, use
|
|
g_buffered_input_stream_set_buffer_size(). Note that the buffer's size
|
|
cannot be reduced below the size of the data within the buffer.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="82"/>
|
|
<implements name="Seekable"/>
|
|
<constructor name="new" c:identifier="g_buffered_input_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12819">Creates a new #GInputStream from the given @base_stream, with
|
|
a buffer set to the default size (4 kilobytes).</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="88"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12826">a #GInputStream for the given @base_stream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12821">a #GInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_sized" c:identifier="g_buffered_input_stream_new_sized">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12830">Creates a new #GBufferedInputStream from the given @base_stream,
|
|
with a buffer set to @size.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12838">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12832">a #GInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12833">a #gsize</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<virtual-method name="fill" invoker="fill" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12732">Tries to read @count bytes from the stream into the buffer.
|
|
Will block during this read.
|
|
|
|
If @count is zero, returns zero and does nothing. A value of @count
|
|
larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes read into the buffer is returned.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file. Zero is returned on end of file
|
|
(or if @count is zero), but never otherwise.
|
|
|
|
If @count is -1 then the attempted read size is equal to the number of
|
|
bytes that are required to fill the buffer.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
On error -1 is returned and @error is set accordingly.
|
|
|
|
For the asynchronous, non-blocking, version of this function, see
|
|
g_buffered_input_stream_fill_async().</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12764">the number of bytes read into @stream's buffer, up to @count,
|
|
or -1 on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12734">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12735">the number of bytes that will be read from the stream</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12736">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fill_async" invoker="fill_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12769">Reads data into @stream's buffer asynchronously, up to @count size.
|
|
@io_priority can be used to prioritize reads. For the synchronous
|
|
version of this function, see g_buffered_input_stream_fill().
|
|
|
|
If @count is -1 then the attempted read size is equal to the number
|
|
of bytes that are required to fill the buffer.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12771">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12772">the number of bytes that will be read from the stream</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12773">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12774">optional #GCancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12775">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12776">a #gpointer</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="fill_finish" invoker="fill_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12787">Finishes an asynchronous read.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12795">a #gssize of the read stream, or `-1` on an error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12789">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12790">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="fill" c:identifier="g_buffered_input_stream_fill" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12732">Tries to read @count bytes from the stream into the buffer.
|
|
Will block during this read.
|
|
|
|
If @count is zero, returns zero and does nothing. A value of @count
|
|
larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes read into the buffer is returned.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file. Zero is returned on end of file
|
|
(or if @count is zero), but never otherwise.
|
|
|
|
If @count is -1 then the attempted read size is equal to the number of
|
|
bytes that are required to fill the buffer.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
On error -1 is returned and @error is set accordingly.
|
|
|
|
For the asynchronous, non-blocking, version of this function, see
|
|
g_buffered_input_stream_fill_async().</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12764">the number of bytes read into @stream's buffer, up to @count,
|
|
or -1 on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12734">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12735">the number of bytes that will be read from the stream</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12736">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="fill_async" c:identifier="g_buffered_input_stream_fill_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12769">Reads data into @stream's buffer asynchronously, up to @count size.
|
|
@io_priority can be used to prioritize reads. For the synchronous
|
|
version of this function, see g_buffered_input_stream_fill().
|
|
|
|
If @count is -1 then the attempted read size is equal to the number
|
|
of bytes that are required to fill the buffer.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12771">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12772">the number of bytes that will be read from the stream</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12773">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12774">optional #GCancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12775">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12776">a #gpointer</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="fill_finish" c:identifier="g_buffered_input_stream_fill_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12787">Finishes an asynchronous read.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12795">a #gssize of the read stream, or `-1` on an error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12789">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12790">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_available" c:identifier="g_buffered_input_stream_get_available">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12799">Gets the size of the available data within the stream.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12805">size of the available stream.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12801">#GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer_size" c:identifier="g_buffered_input_stream_get_buffer_size">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12809">Gets the size of the input buffer.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12815">the current buffer size.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12811">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek" c:identifier="g_buffered_input_stream_peek">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12842">Peeks in the buffer, copying data of size @count into @buffer,
|
|
offset @offset bytes.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12853">a #gsize of the number of bytes peeked, or -1 on error.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12844">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12845">a pointer to
|
|
an allocated chunk of memory</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12847">a #gsize</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12848">a #gsize</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_buffer" c:identifier="g_buffered_input_stream_peek_buffer">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12857">Returns the buffer with the currently available bytes. The returned
|
|
buffer must not be modified and will become invalid when reading from
|
|
the stream or filling the buffer.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12866">
|
|
read-only buffer</doc>
|
|
<array length="0" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12859">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12860">a #gsize to get the number of bytes available in the buffer</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_byte" c:identifier="g_buffered_input_stream_read_byte" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12871">Tries to read a single byte from the stream or the buffer. Will block
|
|
during this read.
|
|
|
|
On success, the byte read from the stream is returned. On end of stream
|
|
-1 is returned but it's not an exceptional error and @error is not set.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="127"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12891">the byte read from the @stream, or -1 on end of stream or error.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12873">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12874">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_buffer_size" c:identifier="g_buffered_input_stream_set_buffer_size">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12895">Sets the size of the internal buffer of @stream to @size, or to the
|
|
size of the contents of the buffer. The buffer can never be resized
|
|
smaller than its current contents.</doc>
|
|
<source-position filename="gbufferedinputstream.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12897">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12898">a #gsize</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="buffer-size" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="FilterInputStream" c:type="GFilterInputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="BufferedInputStreamPrivate" c:type="GBufferedInputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="BufferedInputStreamClass" c:type="GBufferedInputStreamClass" glib:is-gtype-struct-for="BufferedInputStream">
|
|
<source-position filename="gbufferedinputstream.h" line="82"/>
|
|
<field name="parent_class">
|
|
<type name="FilterInputStreamClass" c:type="GFilterInputStreamClass"/>
|
|
</field>
|
|
<field name="fill">
|
|
<callback name="fill" throws="1">
|
|
<source-position filename="gbufferedinputstream.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12764">the number of bytes read into @stream's buffer, up to @count,
|
|
or -1 on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12734">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12735">the number of bytes that will be read from the stream</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12736">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fill_async">
|
|
<callback name="fill_async">
|
|
<source-position filename="gbufferedinputstream.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12771">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12772">the number of bytes that will be read from the stream</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12773">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12774">optional #GCancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12775">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12776">a #gpointer</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="fill_finish">
|
|
<callback name="fill_finish" throws="1">
|
|
<source-position filename="gbufferedinputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12795">a #gssize of the read stream, or `-1` on an error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12789">a #GBufferedInputStream</doc>
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12790">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gbufferedinputstream.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gbufferedinputstream.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gbufferedinputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gbufferedinputstream.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gbufferedinputstream.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="BufferedInputStreamPrivate" c:type="GBufferedInputStreamPrivate" disguised="1">
|
|
<source-position filename="gbufferedinputstream.h" line="45"/>
|
|
</record>
|
|
<class name="BufferedOutputStream" c:symbol-prefix="buffered_output_stream" c:type="GBufferedOutputStream" parent="FilterOutputStream" glib:type-name="GBufferedOutputStream" glib:get-type="g_buffered_output_stream_get_type" glib:type-struct="BufferedOutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5188">Buffered output stream implements #GFilterOutputStream and provides
|
|
for buffered writes.
|
|
|
|
By default, #GBufferedOutputStream's buffer size is set at 4 kilobytes.
|
|
|
|
To create a buffered output stream, use g_buffered_output_stream_new(),
|
|
or g_buffered_output_stream_new_sized() to specify the buffer's size
|
|
at construction.
|
|
|
|
To get the size of a buffer within a buffered input stream, use
|
|
g_buffered_output_stream_get_buffer_size(). To change the size of a
|
|
buffered output stream's buffer, use
|
|
g_buffered_output_stream_set_buffer_size(). Note that the buffer's
|
|
size cannot be reduced below the size of the data within the buffer.</doc>
|
|
<source-position filename="gbufferedoutputstream.h" line="63"/>
|
|
<implements name="Seekable"/>
|
|
<constructor name="new" c:identifier="g_buffered_output_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12927">Creates a new buffered output stream for a base stream.</doc>
|
|
<source-position filename="gbufferedoutputstream.h" line="69"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12933">a #GOutputStream for the given @base_stream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12929">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_sized" c:identifier="g_buffered_output_stream_new_sized">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12937">Creates a new buffered output stream with a given buffer size.</doc>
|
|
<source-position filename="gbufferedoutputstream.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12944">a #GOutputStream with an internal buffer set to @size.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12939">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12940">a #gsize.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_auto_grow" c:identifier="g_buffered_output_stream_get_auto_grow">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12906">Checks if the buffer automatically grows as data is added.</doc>
|
|
<source-position filename="gbufferedoutputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12912">%TRUE if the @stream's buffer automatically grows,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12908">a #GBufferedOutputStream.</doc>
|
|
<type name="BufferedOutputStream" c:type="GBufferedOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_buffer_size" c:identifier="g_buffered_output_stream_get_buffer_size">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12917">Gets the size of the buffer in the @stream.</doc>
|
|
<source-position filename="gbufferedoutputstream.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12923">the current size of the buffer.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12919">a #GBufferedOutputStream.</doc>
|
|
<type name="BufferedOutputStream" c:type="GBufferedOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_auto_grow" c:identifier="g_buffered_output_stream_set_auto_grow">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12948">Sets whether or not the @stream's buffer should automatically grow.
|
|
If @auto_grow is true, then each write will just make the buffer
|
|
larger, and you must manually flush the buffer to actually write out
|
|
the data to the underlying stream.</doc>
|
|
<source-position filename="gbufferedoutputstream.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12950">a #GBufferedOutputStream.</doc>
|
|
<type name="BufferedOutputStream" c:type="GBufferedOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="auto_grow" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12951">a #gboolean.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_buffer_size" c:identifier="g_buffered_output_stream_set_buffer_size">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12960">Sets the size of the internal buffer to @size.</doc>
|
|
<source-position filename="gbufferedoutputstream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12962">a #GBufferedOutputStream.</doc>
|
|
<type name="BufferedOutputStream" c:type="GBufferedOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12963">a #gsize.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="auto-grow" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="buffer-size" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="FilterOutputStream" c:type="GFilterOutputStream"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="BufferedOutputStreamPrivate" c:type="GBufferedOutputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="BufferedOutputStreamClass" c:type="GBufferedOutputStreamClass" glib:is-gtype-struct-for="BufferedOutputStream">
|
|
<source-position filename="gbufferedoutputstream.h" line="63"/>
|
|
<field name="parent_class">
|
|
<type name="FilterOutputStreamClass" c:type="GFilterOutputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gbufferedoutputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gbufferedoutputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="BufferedOutputStreamPrivate" c:type="GBufferedOutputStreamPrivate" disguised="1">
|
|
<source-position filename="gbufferedoutputstream.h" line="45"/>
|
|
</record>
|
|
<callback name="BusAcquiredCallback" c:type="GBusAcquiredCallback" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="32">Invoked when a connection to a message bus has been obtained.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="34">The #GDBusConnection to a message bus.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="35">The name that is requested to be owned.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="36">User data passed to g_bus_own_name().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="BusNameAcquiredCallback" c:type="GBusNameAcquiredCallback" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="46">Invoked when the name is acquired.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="48">The #GDBusConnection on which to acquired the name.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="49">The name being owned.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="50">User data passed to g_bus_own_name() or g_bus_own_name_on_connection().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="BusNameAppearedCallback" c:type="GBusNameAppearedCallback" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="32">Invoked when the name being watched is known to have to have an owner.</doc>
|
|
<source-position filename="gdbusnamewatching.h" line="43"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="34">The #GDBusConnection the name is being watched on.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="35">The name being watched.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="name_owner" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="36">Unique name of the owner of the name being watched.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="37">User data passed to g_bus_watch_name().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="BusNameLostCallback" c:type="GBusNameLostCallback" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="60">Invoked when the name is lost or @connection has been closed.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="62">The #GDBusConnection on which to acquire the name or %NULL if
|
|
the connection was disconnected.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="64">The name being owned.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gdbusnameowning.h" line="65">User data passed to g_bus_own_name() or g_bus_own_name_on_connection().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="BusNameOwnerFlags" version="2.26" glib:type-name="GBusNameOwnerFlags" glib:get-type="g_bus_name_owner_flags_get_type" c:type="GBusNameOwnerFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="969">Flags used in g_bus_own_name().</doc>
|
|
<member name="none" value="0" c:identifier="G_BUS_NAME_OWNER_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="971">No flags set.</doc>
|
|
</member>
|
|
<member name="allow_replacement" value="1" c:identifier="G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT" glib:nick="allow-replacement">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="972">Allow another message bus connection to claim the name.</doc>
|
|
</member>
|
|
<member name="replace" value="2" c:identifier="G_BUS_NAME_OWNER_FLAGS_REPLACE" glib:nick="replace">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="973">If another message bus connection owns the name and have
|
|
specified #G_BUS_NAME_OWNER_FLAGS_ALLOW_REPLACEMENT, then take the name from the other connection.</doc>
|
|
</member>
|
|
<member name="do_not_queue" value="4" c:identifier="G_BUS_NAME_OWNER_FLAGS_DO_NOT_QUEUE" glib:nick="do-not-queue">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="975">If another message bus connection owns the name, immediately
|
|
return an error from g_bus_own_name() rather than entering the waiting queue for that name. (Since 2.54)</doc>
|
|
</member>
|
|
</bitfield>
|
|
<callback name="BusNameVanishedCallback" c:type="GBusNameVanishedCallback" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="48">Invoked when the name being watched is known not to have to have an owner.
|
|
|
|
This is also invoked when the #GDBusConnection on which the watch was
|
|
established has been closed. In that case, @connection will be
|
|
%NULL.</doc>
|
|
<source-position filename="gdbusnamewatching.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="50">The #GDBusConnection the name is being watched on, or
|
|
%NULL.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="52">The name being watched.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gdbusnamewatching.h" line="53">User data passed to g_bus_watch_name().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="BusNameWatcherFlags" version="2.26" glib:type-name="GBusNameWatcherFlags" glib:get-type="g_bus_name_watcher_flags_get_type" c:type="GBusNameWatcherFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="992">Flags used in g_bus_watch_name().</doc>
|
|
<member name="none" value="0" c:identifier="G_BUS_NAME_WATCHER_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="994">No flags set.</doc>
|
|
</member>
|
|
<member name="auto_start" value="1" c:identifier="G_BUS_NAME_WATCHER_FLAGS_AUTO_START" glib:nick="auto-start">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="995">If no-one owns the name when
|
|
beginning to watch the name, ask the bus to launch an owner for the
|
|
name.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<enumeration name="BusType" version="2.26" glib:type-name="GBusType" glib:get-type="g_bus_type_get_type" c:type="GBusType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="950">An enumeration for well-known message buses.</doc>
|
|
<member name="starter" value="-1" c:identifier="G_BUS_TYPE_STARTER" glib:nick="starter">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="952">An alias for the message bus that activated the process, if any.</doc>
|
|
</member>
|
|
<member name="none" value="0" c:identifier="G_BUS_TYPE_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="953">Not a message bus.</doc>
|
|
</member>
|
|
<member name="system" value="1" c:identifier="G_BUS_TYPE_SYSTEM" glib:nick="system">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="954">The system-wide message bus.</doc>
|
|
</member>
|
|
<member name="session" value="2" c:identifier="G_BUS_TYPE_SESSION" glib:nick="session">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="955">The login session message bus.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="BytesIcon" c:symbol-prefix="bytes_icon" c:type="GBytesIcon" version="2.38" parent="GObject.Object" glib:type-name="GBytesIcon" glib:get-type="g_bytes_icon_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5211">#GBytesIcon specifies an image held in memory in a common format (usually
|
|
png) to be used as icon.</doc>
|
|
<implements name="Icon"/>
|
|
<implements name="LoadableIcon"/>
|
|
<constructor name="new" c:identifier="g_bytes_icon_new" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13300">Creates a new icon for a bytes.</doc>
|
|
<source-position filename="gbytesicon.h" line="45"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13306">a #GIcon for the given
|
|
@bytes, or %NULL on error.</doc>
|
|
<type name="BytesIcon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13302">a #GBytes.</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_bytes" c:identifier="g_bytes_icon_get_bytes" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13289">Gets the #GBytes associated with the given @icon.</doc>
|
|
<source-position filename="gbytesicon.h" line="48"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13295">a #GBytes, or %NULL.</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13291">a #GIcon.</doc>
|
|
<type name="BytesIcon" c:type="GBytesIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="bytes" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="477">The bytes containing the icon.</doc>
|
|
<type name="GLib.Bytes"/>
|
|
</property>
|
|
</class>
|
|
<function-macro name="CANCELLABLE" c:identifier="G_CANCELLABLE" introspectable="0">
|
|
<source-position filename="gcancellable.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CANCELLABLE_CLASS" c:identifier="G_CANCELLABLE_CLASS" introspectable="0">
|
|
<source-position filename="gcancellable.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CANCELLABLE_GET_CLASS" c:identifier="G_CANCELLABLE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gcancellable.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CHARSET_CONVERTER" c:identifier="G_CHARSET_CONVERTER" introspectable="0">
|
|
<source-position filename="gcharsetconverter.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CHARSET_CONVERTER_CLASS" c:identifier="G_CHARSET_CONVERTER_CLASS" introspectable="0">
|
|
<source-position filename="gcharsetconverter.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CHARSET_CONVERTER_GET_CLASS" c:identifier="G_CHARSET_CONVERTER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gcharsetconverter.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER" c:identifier="G_CONVERTER" introspectable="0">
|
|
<source-position filename="gconverter.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER_GET_IFACE" c:identifier="G_CONVERTER_GET_IFACE" introspectable="0">
|
|
<source-position filename="gconverter.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER_INPUT_STREAM" c:identifier="G_CONVERTER_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gconverterinputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER_INPUT_STREAM_CLASS" c:identifier="G_CONVERTER_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gconverterinputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER_INPUT_STREAM_GET_CLASS" c:identifier="G_CONVERTER_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gconverterinputstream.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER_OUTPUT_STREAM" c:identifier="G_CONVERTER_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gconverteroutputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER_OUTPUT_STREAM_CLASS" c:identifier="G_CONVERTER_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gconverteroutputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CONVERTER_OUTPUT_STREAM_GET_CLASS" c:identifier="G_CONVERTER_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gconverteroutputstream.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CREDENTIALS" c:identifier="G_CREDENTIALS" introspectable="0">
|
|
<source-position filename="gcredentials.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CREDENTIALS_CLASS" c:identifier="G_CREDENTIALS_CLASS" introspectable="0">
|
|
<source-position filename="gcredentials.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="CREDENTIALS_GET_CLASS" c:identifier="G_CREDENTIALS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gcredentials.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="Cancellable" c:symbol-prefix="cancellable" c:type="GCancellable" parent="GObject.Object" glib:type-name="GCancellable" glib:get-type="g_cancellable_get_type" glib:type-struct="CancellableClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5224">GCancellable is a thread-safe operation cancellation stack used
|
|
throughout GIO to allow for cancellation of synchronous and
|
|
asynchronous operations.</doc>
|
|
<source-position filename="gcancellable.h" line="68"/>
|
|
<constructor name="new" c:identifier="g_cancellable_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13465">Creates a new #GCancellable object.
|
|
|
|
Applications that want to start one or more operations
|
|
that should be cancellable should create a #GCancellable
|
|
and pass it to the operations.
|
|
|
|
One #GCancellable can be used in multiple consecutive
|
|
operations or in multiple concurrent operations.</doc>
|
|
<source-position filename="gcancellable.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13477">a #GCancellable.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<function name="get_current" c:identifier="g_cancellable_get_current">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13391">Gets the top cancellable from the stack.</doc>
|
|
<source-position filename="gcancellable.h" line="95"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13396">a #GCancellable from the top
|
|
of the stack, or %NULL if the stack is empty.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="cancelled">
|
|
<source-position filename="gcancellable.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="cancel" c:identifier="g_cancellable_cancel">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13312">Will set @cancellable to cancelled, and will emit the
|
|
#GCancellable::cancelled signal. (However, see the warning about
|
|
race conditions in the documentation for that signal if you are
|
|
planning to connect to it.)
|
|
|
|
This function is thread-safe. In other words, you can safely call
|
|
it from a thread other than the one running the operation that was
|
|
passed the @cancellable.
|
|
|
|
If @cancellable is %NULL, this function returns immediately for convenience.
|
|
|
|
The convention within GIO is that cancelling an asynchronous
|
|
operation causes it to complete asynchronously. That is, if you
|
|
cancel the operation from the same thread in which it is running,
|
|
then the operation's #GAsyncReadyCallback will not be invoked until
|
|
the application returns to the main loop.</doc>
|
|
<source-position filename="gcancellable.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13314">a #GCancellable object.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect" c:identifier="g_cancellable_connect" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13335">Convenience function to connect to the #GCancellable::cancelled
|
|
signal. Also handles the race condition that may happen
|
|
if the cancellable is cancelled right before connecting.
|
|
|
|
@callback is called at most once, either directly at the
|
|
time of the connect if @cancellable is already cancelled,
|
|
or when @cancellable is cancelled in some thread.
|
|
|
|
@data_destroy_func will be called when the handler is
|
|
disconnected, or immediately if the cancellable is already
|
|
cancelled.
|
|
|
|
See #GCancellable::cancelled for details on how to use this.
|
|
|
|
Since GLib 2.40, the lock protecting @cancellable is not held when
|
|
@callback is invoked. This lifts a restriction in place for
|
|
earlier GLib versions which now makes it easier to write cleanup
|
|
code that unconditionally invokes e.g. g_cancellable_cancel().</doc>
|
|
<source-position filename="gcancellable.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13361">The id of the signal handler or 0 if @cancellable has already
|
|
been cancelled.</doc>
|
|
<type name="gulong" c:type="gulong"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13337">A #GCancellable.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
<parameter name="callback" transfer-ownership="none" scope="notified" closure="1" destroy="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13338">The #GCallback to connect.</doc>
|
|
<type name="GObject.Callback" c:type="GCallback"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13339">Data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="data_destroy_func" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13340">Free function for @data or %NULL.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="disconnect" c:identifier="g_cancellable_disconnect" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13367">Disconnects a handler from a cancellable instance similar to
|
|
g_signal_handler_disconnect(). Additionally, in the event that a
|
|
signal handler is currently running, this call will block until the
|
|
handler has finished. Calling this function from a
|
|
#GCancellable::cancelled signal handler will therefore result in a
|
|
deadlock.
|
|
|
|
This avoids a race condition where a thread cancels at the
|
|
same time as the cancellable operation is finished and the
|
|
signal handler is removed. See #GCancellable::cancelled for
|
|
details on how to use this.
|
|
|
|
If @cancellable is %NULL or @handler_id is `0` this function does
|
|
nothing.</doc>
|
|
<source-position filename="gcancellable.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13369">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
<parameter name="handler_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13370">Handler id of the handler to be disconnected, or `0`.</doc>
|
|
<type name="gulong" c:type="gulong"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_fd" c:identifier="g_cancellable_get_fd">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13401">Gets the file descriptor for a cancellable job. This can be used to
|
|
implement cancellable operations on Unix systems. The returned fd will
|
|
turn readable when @cancellable is cancelled.
|
|
|
|
You are not supposed to read from the fd yourself, just check for
|
|
readable status. Reading to unset the readable status is done
|
|
with g_cancellable_reset().
|
|
|
|
After a successful return from this function, you should use
|
|
g_cancellable_release_fd() to free up resources allocated for
|
|
the returned file descriptor.
|
|
|
|
See also g_cancellable_make_pollfd().</doc>
|
|
<source-position filename="gcancellable.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13419">A valid file descriptor. `-1` if the file descriptor
|
|
is not supported, or on errors.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13403">a #GCancellable.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_cancelled" c:identifier="g_cancellable_is_cancelled">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13424">Checks if a cancellable job has been cancelled.</doc>
|
|
<source-position filename="gcancellable.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13430">%TRUE if @cancellable is cancelled,
|
|
FALSE if called with %NULL or if item is not cancelled.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13426">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="make_pollfd" c:identifier="g_cancellable_make_pollfd" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13435">Creates a #GPollFD corresponding to @cancellable; this can be passed
|
|
to g_poll() and used to poll for cancellation. This is useful both
|
|
for unix systems without a native poll and for portability to
|
|
windows.
|
|
|
|
When this function returns %TRUE, you should use
|
|
g_cancellable_release_fd() to free up resources allocated for the
|
|
@pollfd. After a %FALSE return, do not call g_cancellable_release_fd().
|
|
|
|
If this function returns %FALSE, either no @cancellable was given or
|
|
resource limits prevent this function from allocating the necessary
|
|
structures for polling. (On Linux, you will likely have reached
|
|
the maximum number of file descriptors.) The suggested way to handle
|
|
these cases is to ignore the @cancellable.
|
|
|
|
You are not supposed to read from the fd yourself, just check for
|
|
readable status. Reading to unset the readable status is done
|
|
with g_cancellable_reset().</doc>
|
|
<source-position filename="gcancellable.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13459">%TRUE if @pollfd was successfully initialized, %FALSE on
|
|
failure to prepare the cancellable.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13437">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
<parameter name="pollfd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13438">a pointer to a #GPollFD</doc>
|
|
<type name="GLib.PollFD" c:type="GPollFD*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="pop_current" c:identifier="g_cancellable_pop_current">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13481">Pops @cancellable off the cancellable stack (verifying that @cancellable
|
|
is on the top of the stack).</doc>
|
|
<source-position filename="gcancellable.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13483">a #GCancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="push_current" c:identifier="g_cancellable_push_current">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13490">Pushes @cancellable onto the cancellable stack. The current
|
|
cancellable can then be received using g_cancellable_get_current().
|
|
|
|
This is useful when implementing cancellable operations in
|
|
code that does not allow you to pass down the cancellable object.
|
|
|
|
This is typically called automatically by e.g. #GFile operations,
|
|
so you rarely have to call this yourself.</doc>
|
|
<source-position filename="gcancellable.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13492">a #GCancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="release_fd" c:identifier="g_cancellable_release_fd" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13505">Releases a resources previously allocated by g_cancellable_get_fd()
|
|
or g_cancellable_make_pollfd().
|
|
|
|
For compatibility reasons with older releases, calling this function
|
|
is not strictly required, the resources will be automatically freed
|
|
when the @cancellable is finalized. However, the @cancellable will
|
|
block scarce file descriptors until it is finalized if this function
|
|
is not called. This can cause the application to run out of file
|
|
descriptors when many #GCancellables are used at the same time.</doc>
|
|
<source-position filename="gcancellable.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13507">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset" c:identifier="g_cancellable_reset">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13523">Resets @cancellable to its uncancelled state.
|
|
|
|
If cancellable is currently in use by any cancellable operation
|
|
then the behavior of this function is undefined.
|
|
|
|
Note that it is generally not a good idea to reuse an existing
|
|
cancellable for more operations after it has been cancelled once,
|
|
as this function might tempt you to do. The recommended practice
|
|
is to drop the reference to a cancellable after cancelling it,
|
|
and let it die with the outstanding async operations. You should
|
|
create a fresh cancellable for further async operations.</doc>
|
|
<source-position filename="gcancellable.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13525">a #GCancellable object.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_error_if_cancelled" c:identifier="g_cancellable_set_error_if_cancelled" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13541">If the @cancellable is cancelled, sets the error to notify
|
|
that the operation was cancelled.</doc>
|
|
<source-position filename="gcancellable.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13549">%TRUE if @cancellable was cancelled, %FALSE if it was not</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13543">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="source_new" c:identifier="g_cancellable_source_new" version="2.28" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13553">Creates a source that triggers if @cancellable is cancelled and
|
|
calls its callback of type #GCancellableSourceFunc. This is
|
|
primarily useful for attaching to another (non-cancellable) source
|
|
with g_source_add_child_source() to add cancellability to it.
|
|
|
|
For convenience, you can call this with a %NULL #GCancellable,
|
|
in which case the source will never trigger.
|
|
|
|
The new #GSource will hold a reference to the #GCancellable.</doc>
|
|
<source-position filename="gcancellable.h" line="92"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13567">the new #GSource.</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13555">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="CancellablePrivate" c:type="GCancellablePrivate*"/>
|
|
</field>
|
|
<glib:signal name="cancelled" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="484">Emitted when the operation has been cancelled.
|
|
|
|
Can be used by implementations of cancellable operations. If the
|
|
operation is cancelled from another thread, the signal will be
|
|
emitted in the thread that cancelled the operation, not the
|
|
thread that is running the operation.
|
|
|
|
Note that disconnecting from this signal (or any signal) in a
|
|
multi-threaded program is prone to race conditions. For instance
|
|
it is possible that a signal handler may be invoked even after
|
|
a call to g_signal_handler_disconnect() for that handler has
|
|
already returned.
|
|
|
|
There is also a problem when cancellation happens right before
|
|
connecting to the signal. If this happens the signal will
|
|
unexpectedly not be emitted, and checking before connecting to
|
|
the signal leaves a race condition where this is still happening.
|
|
|
|
In order to make it safe and easy to connect handlers there
|
|
are two helper functions: g_cancellable_connect() and
|
|
g_cancellable_disconnect() which protect against problems
|
|
like this.
|
|
|
|
An example of how to us this:
|
|
|[<!-- language="C" -->
|
|
// Make sure we don't do unnecessary work if already cancelled
|
|
if (g_cancellable_set_error_if_cancelled (cancellable, error))
|
|
return;
|
|
|
|
// Set up all the data needed to be able to handle cancellation
|
|
// of the operation
|
|
my_data = my_data_new (...);
|
|
|
|
id = 0;
|
|
if (cancellable)
|
|
id = g_cancellable_connect (cancellable,
|
|
G_CALLBACK (cancelled_handler)
|
|
data, NULL);
|
|
|
|
// cancellable operation here...
|
|
|
|
g_cancellable_disconnect (cancellable, id);
|
|
|
|
// cancelled_handler is never called after this, it is now safe
|
|
// to free the data
|
|
my_data_free (my_data);
|
|
]|
|
|
|
|
Note that the cancelled signal is emitted in the thread that
|
|
the user cancelled from, which may be the main thread. So, the
|
|
cancellable signal should not do something that can block.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="CancellableClass" c:type="GCancellableClass" glib:is-gtype-struct-for="Cancellable">
|
|
<source-position filename="gcancellable.h" line="68"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="cancelled">
|
|
<callback name="cancelled">
|
|
<source-position filename="gcancellable.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gcancellable.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gcancellable.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gcancellable.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gcancellable.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gcancellable.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="CancellablePrivate" c:type="GCancellablePrivate" disguised="1">
|
|
<source-position filename="gcancellable.h" line="45"/>
|
|
</record>
|
|
<callback name="CancellableSourceFunc" c:type="GCancellableSourceFunc" version="2.28">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="567">This is the function type of the callback used for the #GSource
|
|
returned by g_cancellable_source_new().</doc>
|
|
<source-position filename="giotypes.h" line="579"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="575">it should return %FALSE if the source should be removed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="569">the #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="570">data passed in by the user.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="CharsetConverter" c:symbol-prefix="charset_converter" c:type="GCharsetConverter" parent="GObject.Object" glib:type-name="GCharsetConverter" glib:get-type="g_charset_converter_get_type" glib:type-struct="CharsetConverterClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5235">#GCharsetConverter is an implementation of #GConverter based on
|
|
GIConv.</doc>
|
|
<source-position filename="gcharsetconverter.h" line="44"/>
|
|
<implements name="Converter"/>
|
|
<implements name="Initable"/>
|
|
<constructor name="new" c:identifier="g_charset_converter_new" version="2.24" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13594">Creates a new #GCharsetConverter.</doc>
|
|
<source-position filename="gcharsetconverter.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13602">a new #GCharsetConverter or %NULL on error.</doc>
|
|
<type name="CharsetConverter" c:type="GCharsetConverter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="to_charset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13596">destination charset</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="from_charset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13597">source charset</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_num_fallbacks" c:identifier="g_charset_converter_get_num_fallbacks" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13572">Gets the number of fallbacks that @converter has applied so far.</doc>
|
|
<source-position filename="gcharsetconverter.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13578">the number of fallbacks that @converter has applied</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13574">a #GCharsetConverter</doc>
|
|
<type name="CharsetConverter" c:type="GCharsetConverter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_use_fallback" c:identifier="g_charset_converter_get_use_fallback" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13583">Gets the #GCharsetConverter:use-fallback property.</doc>
|
|
<source-position filename="gcharsetconverter.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13589">%TRUE if fallbacks are used by @converter</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13585">a #GCharsetConverter</doc>
|
|
<type name="CharsetConverter" c:type="GCharsetConverter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_use_fallback" c:identifier="g_charset_converter_set_use_fallback" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13607">Sets the #GCharsetConverter:use-fallback property.</doc>
|
|
<source-position filename="gcharsetconverter.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13609">a #GCharsetConverter</doc>
|
|
<type name="CharsetConverter" c:type="GCharsetConverter*"/>
|
|
</instance-parameter>
|
|
<parameter name="use_fallback" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13610">%TRUE to use fallbacks</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="from-charset" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="to-charset" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="use-fallback" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
</class>
|
|
<record name="CharsetConverterClass" c:type="GCharsetConverterClass" glib:is-gtype-struct-for="CharsetConverter">
|
|
<source-position filename="gcharsetconverter.h" line="44"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<interface name="Converter" c:symbol-prefix="converter" c:type="GConverter" version="2.24" glib:type-name="GConverter" glib:get-type="g_converter_get_type" glib:type-struct="ConverterIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5262">#GConverter is implemented by objects that convert
|
|
binary data in various ways. The conversion can be
|
|
stateful and may fail at any place.
|
|
|
|
Some example conversions are: character set conversion,
|
|
compression, decompression and regular expression
|
|
replace.</doc>
|
|
<source-position filename="gconverter.h" line="74"/>
|
|
<virtual-method name="convert" invoker="convert" version="2.24" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13854">This is the main operation used when converting data. It is to be called
|
|
multiple times in a loop, and each time it will do some work, i.e.
|
|
producing some output (in @outbuf) or consuming some input (from @inbuf) or
|
|
both. If its not possible to do any work an error is returned.
|
|
|
|
Note that a single call may not consume all input (or any input at all).
|
|
Also a call may produce output even if given no input, due to state stored
|
|
in the converter producing output.
|
|
|
|
If any data was either produced or consumed, and then an error happens, then
|
|
only the successful conversion is reported and the error is returned on the
|
|
next call.
|
|
|
|
A full conversion loop involves calling this method repeatedly, each time
|
|
giving it new input and space output space. When there is no more input
|
|
data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set.
|
|
The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED
|
|
each time until all data is consumed and all output is produced, then
|
|
%G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED
|
|
may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance
|
|
in a decompression converter where the end of data is detectable from the
|
|
data (and there might even be other data after the end of the compressed data).
|
|
|
|
When some data has successfully been converted @bytes_read and is set to
|
|
the number of bytes read from @inbuf, and @bytes_written is set to indicate
|
|
how many bytes was written to @outbuf. If there are more data to output
|
|
or consume (i.e. unless the %G_CONVERTER_INPUT_AT_END is specified) then
|
|
%G_CONVERTER_CONVERTED is returned, and if no more data is to be output
|
|
then %G_CONVERTER_FINISHED is returned.
|
|
|
|
On error %G_CONVERTER_ERROR is returned and @error is set accordingly.
|
|
Some errors need special handling:
|
|
|
|
%G_IO_ERROR_NO_SPACE is returned if there is not enough space
|
|
to write the resulting converted data, the application should
|
|
call the function again with a larger @outbuf to continue.
|
|
|
|
%G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough
|
|
input to fully determine what the conversion should produce,
|
|
and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for
|
|
example with an incomplete multibyte sequence when converting text,
|
|
or when a regexp matches up to the end of the input (and may match
|
|
further input). It may also happen when @inbuf_size is zero and
|
|
there is no more data to produce.
|
|
|
|
When this happens the application should read more input and then
|
|
call the function again. If further input shows that there is no
|
|
more data call the function again with the same data but with
|
|
the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion
|
|
to finish as e.g. in the regexp match case (or, to fail again with
|
|
%G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the
|
|
input is actually partial).
|
|
|
|
After g_converter_convert() has returned %G_CONVERTER_FINISHED the
|
|
converter object is in an invalid state where its not allowed
|
|
to call g_converter_convert() anymore. At this time you can only
|
|
free the object or call g_converter_reset() to reset it to the
|
|
initial state.
|
|
|
|
If the flag %G_CONVERTER_FLUSH is set then conversion is modified
|
|
to try to write out all internal state to the output. The application
|
|
has to call the function multiple times with the flag set, and when
|
|
the available input has been consumed and all internal state has
|
|
been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if
|
|
really at the end) is returned instead of %G_CONVERTER_CONVERTED.
|
|
This is somewhat similar to what happens at the end of the input stream,
|
|
but done in the middle of the data.
|
|
|
|
This has different meanings for different conversions. For instance
|
|
in a compression converter it would mean that we flush all the
|
|
compression state into output such that if you uncompress the
|
|
compressed data you get back all the input data. Doing this may
|
|
make the final file larger due to padding though. Another example
|
|
is a regexp conversion, where if you at the end of the flushed data
|
|
have a match, but there is also a potential longer match. In the
|
|
non-flushed case we would ask for more input, but when flushing we
|
|
treat this as the end of input and do the match.
|
|
|
|
Flushing is not always possible (like if a charset converter flushes
|
|
at a partial multibyte sequence). Converters are supposed to try
|
|
to produce as much output as possible and then return an error
|
|
(typically %G_IO_ERROR_PARTIAL_INPUT).</doc>
|
|
<source-position filename="gconverter.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13951">a #GConverterResult, %G_CONVERTER_ERROR on error.</doc>
|
|
<type name="ConverterResult" c:type="GConverterResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13856">a #GConverter.</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</instance-parameter>
|
|
<parameter name="inbuf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13857">the buffer
|
|
containing the data to convert.</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="inbuf_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13859">the number of bytes in @inbuf</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13860">a buffer to write
|
|
converted data in.</doc>
|
|
<array length="3" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="outbuf_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13862">the number of bytes in @outbuf, must be at least one</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13863">a #GConverterFlags controlling the conversion details</doc>
|
|
<type name="ConverterFlags" c:type="GConverterFlags"/>
|
|
</parameter>
|
|
<parameter name="bytes_read" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13864">will be set to the number of bytes read from @inbuf on success</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13865">will be set to the number of bytes written to @outbuf on success</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="reset" invoker="reset" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14000">Resets all internal state in the converter, making it behave
|
|
as if it was just created. If the converter has any internal
|
|
state that would produce output then that output is lost.</doc>
|
|
<source-position filename="gconverter.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14002">a #GConverter.</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="convert" c:identifier="g_converter_convert" version="2.24" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13854">This is the main operation used when converting data. It is to be called
|
|
multiple times in a loop, and each time it will do some work, i.e.
|
|
producing some output (in @outbuf) or consuming some input (from @inbuf) or
|
|
both. If its not possible to do any work an error is returned.
|
|
|
|
Note that a single call may not consume all input (or any input at all).
|
|
Also a call may produce output even if given no input, due to state stored
|
|
in the converter producing output.
|
|
|
|
If any data was either produced or consumed, and then an error happens, then
|
|
only the successful conversion is reported and the error is returned on the
|
|
next call.
|
|
|
|
A full conversion loop involves calling this method repeatedly, each time
|
|
giving it new input and space output space. When there is no more input
|
|
data after the data in @inbuf, the flag %G_CONVERTER_INPUT_AT_END must be set.
|
|
The loop will be (unless some error happens) returning %G_CONVERTER_CONVERTED
|
|
each time until all data is consumed and all output is produced, then
|
|
%G_CONVERTER_FINISHED is returned instead. Note, that %G_CONVERTER_FINISHED
|
|
may be returned even if %G_CONVERTER_INPUT_AT_END is not set, for instance
|
|
in a decompression converter where the end of data is detectable from the
|
|
data (and there might even be other data after the end of the compressed data).
|
|
|
|
When some data has successfully been converted @bytes_read and is set to
|
|
the number of bytes read from @inbuf, and @bytes_written is set to indicate
|
|
how many bytes was written to @outbuf. If there are more data to output
|
|
or consume (i.e. unless the %G_CONVERTER_INPUT_AT_END is specified) then
|
|
%G_CONVERTER_CONVERTED is returned, and if no more data is to be output
|
|
then %G_CONVERTER_FINISHED is returned.
|
|
|
|
On error %G_CONVERTER_ERROR is returned and @error is set accordingly.
|
|
Some errors need special handling:
|
|
|
|
%G_IO_ERROR_NO_SPACE is returned if there is not enough space
|
|
to write the resulting converted data, the application should
|
|
call the function again with a larger @outbuf to continue.
|
|
|
|
%G_IO_ERROR_PARTIAL_INPUT is returned if there is not enough
|
|
input to fully determine what the conversion should produce,
|
|
and the %G_CONVERTER_INPUT_AT_END flag is not set. This happens for
|
|
example with an incomplete multibyte sequence when converting text,
|
|
or when a regexp matches up to the end of the input (and may match
|
|
further input). It may also happen when @inbuf_size is zero and
|
|
there is no more data to produce.
|
|
|
|
When this happens the application should read more input and then
|
|
call the function again. If further input shows that there is no
|
|
more data call the function again with the same data but with
|
|
the %G_CONVERTER_INPUT_AT_END flag set. This may cause the conversion
|
|
to finish as e.g. in the regexp match case (or, to fail again with
|
|
%G_IO_ERROR_PARTIAL_INPUT in e.g. a charset conversion where the
|
|
input is actually partial).
|
|
|
|
After g_converter_convert() has returned %G_CONVERTER_FINISHED the
|
|
converter object is in an invalid state where its not allowed
|
|
to call g_converter_convert() anymore. At this time you can only
|
|
free the object or call g_converter_reset() to reset it to the
|
|
initial state.
|
|
|
|
If the flag %G_CONVERTER_FLUSH is set then conversion is modified
|
|
to try to write out all internal state to the output. The application
|
|
has to call the function multiple times with the flag set, and when
|
|
the available input has been consumed and all internal state has
|
|
been produced then %G_CONVERTER_FLUSHED (or %G_CONVERTER_FINISHED if
|
|
really at the end) is returned instead of %G_CONVERTER_CONVERTED.
|
|
This is somewhat similar to what happens at the end of the input stream,
|
|
but done in the middle of the data.
|
|
|
|
This has different meanings for different conversions. For instance
|
|
in a compression converter it would mean that we flush all the
|
|
compression state into output such that if you uncompress the
|
|
compressed data you get back all the input data. Doing this may
|
|
make the final file larger due to padding though. Another example
|
|
is a regexp conversion, where if you at the end of the flushed data
|
|
have a match, but there is also a potential longer match. In the
|
|
non-flushed case we would ask for more input, but when flushing we
|
|
treat this as the end of input and do the match.
|
|
|
|
Flushing is not always possible (like if a charset converter flushes
|
|
at a partial multibyte sequence). Converters are supposed to try
|
|
to produce as much output as possible and then return an error
|
|
(typically %G_IO_ERROR_PARTIAL_INPUT).</doc>
|
|
<source-position filename="gconverter.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13951">a #GConverterResult, %G_CONVERTER_ERROR on error.</doc>
|
|
<type name="ConverterResult" c:type="GConverterResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13856">a #GConverter.</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</instance-parameter>
|
|
<parameter name="inbuf" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13857">the buffer
|
|
containing the data to convert.</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="inbuf_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13859">the number of bytes in @inbuf</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13860">a buffer to write
|
|
converted data in.</doc>
|
|
<array length="3" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="outbuf_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13862">the number of bytes in @outbuf, must be at least one</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13863">a #GConverterFlags controlling the conversion details</doc>
|
|
<type name="ConverterFlags" c:type="GConverterFlags"/>
|
|
</parameter>
|
|
<parameter name="bytes_read" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13864">will be set to the number of bytes read from @inbuf on success</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13865">will be set to the number of bytes written to @outbuf on success</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset" c:identifier="g_converter_reset" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14000">Resets all internal state in the converter, making it behave
|
|
as if it was just created. If the converter has any internal
|
|
state that would produce output then that output is lost.</doc>
|
|
<source-position filename="gconverter.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14002">a #GConverter.</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<bitfield name="ConverterFlags" version="2.24" glib:type-name="GConverterFlags" glib:get-type="g_converter_flags_get_type" c:type="GConverterFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="49">Flags used when calling a g_converter_convert().</doc>
|
|
<member name="none" value="0" c:identifier="G_CONVERTER_NO_FLAGS" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="51">No flags.</doc>
|
|
</member>
|
|
<member name="input_at_end" value="1" c:identifier="G_CONVERTER_INPUT_AT_END" glib:nick="input-at-end">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="52">At end of input data</doc>
|
|
</member>
|
|
<member name="flush" value="2" c:identifier="G_CONVERTER_FLUSH" glib:nick="flush">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="53">Flush data</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="ConverterIface" c:type="GConverterIface" glib:is-gtype-struct-for="Converter" version="2.24">
|
|
<doc xml:space="preserve" filename="gconverter.h" line="46">Provides an interface for converting data from one type
|
|
to another type. The conversion can be stateful
|
|
and may fail at any place.</doc>
|
|
<source-position filename="gconverter.h" line="74"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gconverter.h" line="48">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="convert">
|
|
<callback name="convert" throws="1">
|
|
<source-position filename="gconverter.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13951">a #GConverterResult, %G_CONVERTER_ERROR on error.</doc>
|
|
<type name="ConverterResult" c:type="GConverterResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13856">a #GConverter.</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</parameter>
|
|
<parameter name="inbuf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13857">the buffer
|
|
containing the data to convert.</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="inbuf_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13859">the number of bytes in @inbuf</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="outbuf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13860">a buffer to write
|
|
converted data in.</doc>
|
|
<array length="4" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="outbuf_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13862">the number of bytes in @outbuf, must be at least one</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13863">a #GConverterFlags controlling the conversion details</doc>
|
|
<type name="ConverterFlags" c:type="GConverterFlags"/>
|
|
</parameter>
|
|
<parameter name="bytes_read" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13864">will be set to the number of bytes read from @inbuf on success</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13865">will be set to the number of bytes written to @outbuf on success</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="reset">
|
|
<callback name="reset">
|
|
<source-position filename="gconverter.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14002">a #GConverter.</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="ConverterInputStream" c:symbol-prefix="converter_input_stream" c:type="GConverterInputStream" parent="FilterInputStream" glib:type-name="GConverterInputStream" glib:get-type="g_converter_input_stream_get_type" glib:type-struct="ConverterInputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5280">Converter input stream implements #GInputStream and allows
|
|
conversion of data of various types during reading.
|
|
|
|
As of GLib 2.34, #GConverterInputStream implements
|
|
#GPollableInputStream.</doc>
|
|
<source-position filename="gconverterinputstream.h" line="68"/>
|
|
<implements name="PollableInputStream"/>
|
|
<constructor name="new" c:identifier="g_converter_input_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13967">Creates a new converter input stream for the @base_stream.</doc>
|
|
<source-position filename="gconverterinputstream.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13974">a new #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13969">a #GInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13970">a #GConverter</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_converter" c:identifier="g_converter_input_stream_get_converter" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13956">Gets the #GConverter that is used by @converter_stream.</doc>
|
|
<source-position filename="gconverterinputstream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13962">the converter of the converter input stream</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13958">a #GConverterInputStream</doc>
|
|
<type name="ConverterInputStream" c:type="GConverterInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="converter" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="Converter"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="FilterInputStream" c:type="GFilterInputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="ConverterInputStreamPrivate" c:type="GConverterInputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="ConverterInputStreamClass" c:type="GConverterInputStreamClass" glib:is-gtype-struct-for="ConverterInputStream">
|
|
<source-position filename="gconverterinputstream.h" line="68"/>
|
|
<field name="parent_class">
|
|
<type name="FilterInputStreamClass" c:type="GFilterInputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gconverterinputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gconverterinputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gconverterinputstream.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gconverterinputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gconverterinputstream.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="ConverterInputStreamPrivate" c:type="GConverterInputStreamPrivate" disguised="1">
|
|
<source-position filename="gconverterinputstream.h" line="47"/>
|
|
</record>
|
|
<class name="ConverterOutputStream" c:symbol-prefix="converter_output_stream" c:type="GConverterOutputStream" parent="FilterOutputStream" glib:type-name="GConverterOutputStream" glib:get-type="g_converter_output_stream_get_type" glib:type-struct="ConverterOutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5294">Converter output stream implements #GOutputStream and allows
|
|
conversion of data of various types during reading.
|
|
|
|
As of GLib 2.34, #GConverterOutputStream implements
|
|
#GPollableOutputStream.</doc>
|
|
<source-position filename="gconverteroutputstream.h" line="68"/>
|
|
<implements name="PollableOutputStream"/>
|
|
<constructor name="new" c:identifier="g_converter_output_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13989">Creates a new converter output stream for the @base_stream.</doc>
|
|
<source-position filename="gconverteroutputstream.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13996">a new #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13991">a #GOutputStream</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="converter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13992">a #GConverter</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_converter" c:identifier="g_converter_output_stream_get_converter" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13978">Gets the #GConverter that is used by @converter_stream.</doc>
|
|
<source-position filename="gconverteroutputstream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13984">the converter of the converter output stream</doc>
|
|
<type name="Converter" c:type="GConverter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="converter_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13980">a #GConverterOutputStream</doc>
|
|
<type name="ConverterOutputStream" c:type="GConverterOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="converter" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="Converter"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="FilterOutputStream" c:type="GFilterOutputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="ConverterOutputStreamPrivate" c:type="GConverterOutputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="ConverterOutputStreamClass" c:type="GConverterOutputStreamClass" glib:is-gtype-struct-for="ConverterOutputStream">
|
|
<source-position filename="gconverteroutputstream.h" line="68"/>
|
|
<field name="parent_class">
|
|
<type name="FilterOutputStreamClass" c:type="GFilterOutputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gconverteroutputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gconverteroutputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gconverteroutputstream.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gconverteroutputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gconverteroutputstream.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="ConverterOutputStreamPrivate" c:type="GConverterOutputStreamPrivate" disguised="1">
|
|
<source-position filename="gconverteroutputstream.h" line="47"/>
|
|
</record>
|
|
<enumeration name="ConverterResult" version="2.24" glib:type-name="GConverterResult" glib:get-type="g_converter_result_get_type" c:type="GConverterResult">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="65">Results returned from g_converter_convert().</doc>
|
|
<member name="error" value="0" c:identifier="G_CONVERTER_ERROR" glib:nick="error">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="67">There was an error during conversion.</doc>
|
|
</member>
|
|
<member name="converted" value="1" c:identifier="G_CONVERTER_CONVERTED" glib:nick="converted">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="68">Some data was consumed or produced</doc>
|
|
</member>
|
|
<member name="finished" value="2" c:identifier="G_CONVERTER_FINISHED" glib:nick="finished">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="69">The conversion is finished</doc>
|
|
</member>
|
|
<member name="flushed" value="3" c:identifier="G_CONVERTER_FLUSHED" glib:nick="flushed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="70">Flushing is finished</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="Credentials" c:symbol-prefix="credentials" c:type="GCredentials" version="2.26" parent="GObject.Object" glib:type-name="GCredentials" glib:get-type="g_credentials_get_type" glib:type-struct="CredentialsClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5308">The #GCredentials type is a reference-counted wrapper for native
|
|
credentials. This information is typically used for identifying,
|
|
authenticating and authorizing other processes.
|
|
|
|
Some operating systems supports looking up the credentials of the
|
|
remote peer of a communication endpoint - see e.g.
|
|
g_socket_get_credentials().
|
|
|
|
Some operating systems supports securely sending and receiving
|
|
credentials over a Unix Domain Socket, see
|
|
#GUnixCredentialsMessage, g_unix_connection_send_credentials() and
|
|
g_unix_connection_receive_credentials() for details.
|
|
|
|
On Linux, the native credential type is a struct ucred - see the
|
|
unix(7) man page for details. This corresponds to
|
|
%G_CREDENTIALS_TYPE_LINUX_UCRED.
|
|
|
|
On FreeBSD, Debian GNU/kFreeBSD, and GNU/Hurd, the native
|
|
credential type is a struct cmsgcred. This corresponds
|
|
to %G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED.
|
|
|
|
On NetBSD, the native credential type is a struct unpcbid.
|
|
This corresponds to %G_CREDENTIALS_TYPE_NETBSD_UNPCBID.
|
|
|
|
On OpenBSD, the native credential type is a struct sockpeercred.
|
|
This corresponds to %G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED.
|
|
|
|
On Solaris (including OpenSolaris and its derivatives), the native
|
|
credential type is a ucred_t. This corresponds to
|
|
%G_CREDENTIALS_TYPE_SOLARIS_UCRED.</doc>
|
|
<source-position filename="gcredentials.h" line="45"/>
|
|
<constructor name="new" c:identifier="g_credentials_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14083">Creates a new #GCredentials object with credentials matching the
|
|
the current process.</doc>
|
|
<source-position filename="gcredentials.h" line="51"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14089">A #GCredentials. Free with g_object_unref().</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="get_native" c:identifier="g_credentials_get_native" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14012">Gets a pointer to native credentials of type @native_type from
|
|
@credentials.
|
|
|
|
It is a programming error (which will cause an warning to be
|
|
logged) to use this method if there is no #GCredentials support for
|
|
the OS or if @native_type isn't supported by the OS.</doc>
|
|
<source-position filename="gcredentials.h" line="57"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14024">The pointer to native credentials or %NULL if the
|
|
operation there is no #GCredentials support for the OS or if
|
|
@native_type isn't supported by the OS. Do not free the returned
|
|
data, it is owned by @credentials.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14014">A #GCredentials.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</instance-parameter>
|
|
<parameter name="native_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14015">The type of native credentials to get.</doc>
|
|
<type name="CredentialsType" c:type="GCredentialsType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_unix_pid" c:identifier="g_credentials_get_unix_pid" version="2.36" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14032">Tries to get the UNIX process identifier from @credentials. This
|
|
method is only available on UNIX platforms.
|
|
|
|
This operation can fail if #GCredentials is not supported on the
|
|
OS or if the native credentials type does not contain information
|
|
about the UNIX process ID.</doc>
|
|
<source-position filename="gcredentials.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14044">The UNIX process ID, or -1 if @error is set.</doc>
|
|
<type name="gint" c:type="pid_t"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14034">A #GCredentials</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_unix_user" c:identifier="g_credentials_get_unix_user" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14049">Tries to get the UNIX user identifier from @credentials. This
|
|
method is only available on UNIX platforms.
|
|
|
|
This operation can fail if #GCredentials is not supported on the
|
|
OS or if the native credentials type does not contain information
|
|
about the UNIX user.</doc>
|
|
<source-position filename="gcredentials.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14061">The UNIX user identifier or -1 if @error is set.</doc>
|
|
<type name="guint" c:type="uid_t"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14051">A #GCredentials</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_same_user" c:identifier="g_credentials_is_same_user" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14066">Checks if @credentials and @other_credentials is the same user.
|
|
|
|
This operation can fail if #GCredentials is not supported on the
|
|
the OS.</doc>
|
|
<source-position filename="gcredentials.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14077">%TRUE if @credentials and @other_credentials has the same
|
|
user, %FALSE otherwise or if @error is set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14068">A #GCredentials.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</instance-parameter>
|
|
<parameter name="other_credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14069">A #GCredentials.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_native" c:identifier="g_credentials_set_native" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14094">Copies the native credentials of type @native_type from @native
|
|
into @credentials.
|
|
|
|
It is a programming error (which will cause an warning to be
|
|
logged) to use this method if there is no #GCredentials support for
|
|
the OS or if @native_type isn't supported by the OS.</doc>
|
|
<source-position filename="gcredentials.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14096">A #GCredentials.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</instance-parameter>
|
|
<parameter name="native_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14097">The type of native credentials to set.</doc>
|
|
<type name="CredentialsType" c:type="GCredentialsType"/>
|
|
</parameter>
|
|
<parameter name="native" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14098">A pointer to native credentials.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_unix_user" c:identifier="g_credentials_set_unix_user" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14111">Tries to set the UNIX user identifier on @credentials. This method
|
|
is only available on UNIX platforms.
|
|
|
|
This operation can fail if #GCredentials is not supported on the
|
|
OS or if the native credentials type does not contain information
|
|
about the UNIX user. It can also fail if the OS does not allow the
|
|
use of "spoofed" credentials.</doc>
|
|
<source-position filename="gcredentials.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14125">%TRUE if @uid was set, %FALSE if error is set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14113">A #GCredentials.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</instance-parameter>
|
|
<parameter name="uid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14114">The UNIX user identifier to set.</doc>
|
|
<type name="guint" c:type="uid_t"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_string" c:identifier="g_credentials_to_string" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14130">Creates a human-readable textual representation of @credentials
|
|
that can be used in logging and debug messages. The format of the
|
|
returned string may change in future GLib release.</doc>
|
|
<source-position filename="gcredentials.h" line="54"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14138">A string that should be freed with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14132">A #GCredentials object.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<record name="CredentialsClass" c:type="GCredentialsClass" disguised="1" glib:is-gtype-struct-for="Credentials" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="559">Class structure for #GCredentials.</doc>
|
|
<source-position filename="gcredentials.h" line="45"/>
|
|
</record>
|
|
<enumeration name="CredentialsType" version="2.26" glib:type-name="GCredentialsType" glib:get-type="g_credentials_type_get_type" c:type="GCredentialsType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1423">Enumeration describing different kinds of native credential types.</doc>
|
|
<member name="invalid" value="0" c:identifier="G_CREDENTIALS_TYPE_INVALID" glib:nick="invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1425">Indicates an invalid native credential type.</doc>
|
|
</member>
|
|
<member name="linux_ucred" value="1" c:identifier="G_CREDENTIALS_TYPE_LINUX_UCRED" glib:nick="linux-ucred">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1426">The native credentials type is a struct ucred.</doc>
|
|
</member>
|
|
<member name="freebsd_cmsgcred" value="2" c:identifier="G_CREDENTIALS_TYPE_FREEBSD_CMSGCRED" glib:nick="freebsd-cmsgcred">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1427">The native credentials type is a struct cmsgcred.</doc>
|
|
</member>
|
|
<member name="openbsd_sockpeercred" value="3" c:identifier="G_CREDENTIALS_TYPE_OPENBSD_SOCKPEERCRED" glib:nick="openbsd-sockpeercred">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1428">The native credentials type is a struct sockpeercred. Added in 2.30.</doc>
|
|
</member>
|
|
<member name="solaris_ucred" value="4" c:identifier="G_CREDENTIALS_TYPE_SOLARIS_UCRED" glib:nick="solaris-ucred">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1429">The native credentials type is a ucred_t. Added in 2.40.</doc>
|
|
</member>
|
|
<member name="netbsd_unpcbid" value="5" c:identifier="G_CREDENTIALS_TYPE_NETBSD_UNPCBID" glib:nick="netbsd-unpcbid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1430">The native credentials type is a struct unpcbid.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<function-macro name="DATAGRAM_BASED" c:identifier="G_DATAGRAM_BASED" introspectable="0">
|
|
<source-position filename="gdatagrambased.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATAGRAM_BASED_GET_IFACE" c:identifier="G_DATAGRAM_BASED_GET_IFACE" introspectable="0">
|
|
<source-position filename="gdatagrambased.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATA_INPUT_STREAM" c:identifier="G_DATA_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gdatainputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATA_INPUT_STREAM_CLASS" c:identifier="G_DATA_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gdatainputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATA_INPUT_STREAM_GET_CLASS" c:identifier="G_DATA_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdatainputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATA_OUTPUT_STREAM" c:identifier="G_DATA_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gdataoutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATA_OUTPUT_STREAM_CLASS" c:identifier="G_DATA_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gdataoutputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DATA_OUTPUT_STREAM_GET_CLASS" c:identifier="G_DATA_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdataoutputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_ACTION_GROUP" c:identifier="G_DBUS_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gdbusactiongroup.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_ACTION_GROUP_CLASS" c:identifier="G_DBUS_ACTION_GROUP_CLASS" introspectable="0">
|
|
<source-position filename="gdbusactiongroup.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_ACTION_GROUP_GET_CLASS" c:identifier="G_DBUS_ACTION_GROUP_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdbusactiongroup.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_AUTH_OBSERVER" c:identifier="G_DBUS_AUTH_OBSERVER" introspectable="0">
|
|
<source-position filename="gdbusauthobserver.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_CONNECTION" c:identifier="G_DBUS_CONNECTION" introspectable="0">
|
|
<source-position filename="gdbusconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_INTERFACE" c:identifier="G_DBUS_INTERFACE" introspectable="0">
|
|
<source-position filename="gdbusinterface.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_INTERFACE_GET_IFACE" c:identifier="G_DBUS_INTERFACE_GET_IFACE" introspectable="0">
|
|
<source-position filename="gdbusinterface.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_INTERFACE_SKELETON" c:identifier="G_DBUS_INTERFACE_SKELETON" introspectable="0">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_INTERFACE_SKELETON_CLASS" c:identifier="G_DBUS_INTERFACE_SKELETON_CLASS" introspectable="0">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_INTERFACE_SKELETON_GET_CLASS" c:identifier="G_DBUS_INTERFACE_SKELETON_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_MENU_MODEL" c:identifier="G_DBUS_MENU_MODEL" introspectable="0">
|
|
<source-position filename="gdbusmenumodel.h" line="28"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_MESSAGE" c:identifier="G_DBUS_MESSAGE" introspectable="0">
|
|
<source-position filename="gdbusmessage.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_METHOD_INVOCATION" c:identifier="G_DBUS_METHOD_INVOCATION" introspectable="0">
|
|
<source-position filename="gdbusmethodinvocation.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT" c:identifier="G_DBUS_OBJECT" introspectable="0">
|
|
<source-position filename="gdbusobject.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_GET_IFACE" c:identifier="G_DBUS_OBJECT_GET_IFACE" introspectable="0">
|
|
<source-position filename="gdbusobject.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER" c:identifier="G_DBUS_OBJECT_MANAGER" introspectable="0">
|
|
<source-position filename="gdbusobjectmanager.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER_CLIENT" c:identifier="G_DBUS_OBJECT_MANAGER_CLIENT" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER_CLIENT_CLASS" c:identifier="G_DBUS_OBJECT_MANAGER_CLIENT_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER_CLIENT_GET_CLASS" c:identifier="G_DBUS_OBJECT_MANAGER_CLIENT_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER_GET_IFACE" c:identifier="G_DBUS_OBJECT_MANAGER_GET_IFACE" introspectable="0">
|
|
<source-position filename="gdbusobjectmanager.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER_SERVER" c:identifier="G_DBUS_OBJECT_MANAGER_SERVER" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER_SERVER_CLASS" c:identifier="G_DBUS_OBJECT_MANAGER_SERVER_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_MANAGER_SERVER_GET_CLASS" c:identifier="G_DBUS_OBJECT_MANAGER_SERVER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_PROXY" c:identifier="G_DBUS_OBJECT_PROXY" introspectable="0">
|
|
<source-position filename="gdbusobjectproxy.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_PROXY_CLASS" c:identifier="G_DBUS_OBJECT_PROXY_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectproxy.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_PROXY_GET_CLASS" c:identifier="G_DBUS_OBJECT_PROXY_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectproxy.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_SKELETON" c:identifier="G_DBUS_OBJECT_SKELETON" introspectable="0">
|
|
<source-position filename="gdbusobjectskeleton.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_SKELETON_CLASS" c:identifier="G_DBUS_OBJECT_SKELETON_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectskeleton.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_OBJECT_SKELETON_GET_CLASS" c:identifier="G_DBUS_OBJECT_SKELETON_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectskeleton.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_PROXY" c:identifier="G_DBUS_PROXY" introspectable="0">
|
|
<source-position filename="gdbusproxy.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_PROXY_CLASS" c:identifier="G_DBUS_PROXY_CLASS" introspectable="0">
|
|
<source-position filename="gdbusproxy.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_PROXY_GET_CLASS" c:identifier="G_DBUS_PROXY_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdbusproxy.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DBUS_SERVER" c:identifier="G_DBUS_SERVER" introspectable="0">
|
|
<source-position filename="gdbusserver.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="DBusActionGroup" c:symbol-prefix="dbus_action_group" c:type="GDBusActionGroup" parent="GObject.Object" glib:type-name="GDBusActionGroup" glib:get-type="g_dbus_action_group_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5426">#GDBusActionGroup is an implementation of the #GActionGroup
|
|
interface that can be used as a proxy for an action group
|
|
that is exported over D-Bus with g_dbus_connection_export_action_group().</doc>
|
|
<implements name="ActionGroup"/>
|
|
<implements name="RemoteActionGroup"/>
|
|
<function name="get" c:identifier="g_dbus_action_group_get" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14954">Obtains a #GDBusActionGroup for the action group which is exported at
|
|
the given @bus_name and @object_path.
|
|
|
|
The thread default main context is taken at the time of this call.
|
|
All signals on the menu model (and any linked models) are reported
|
|
with respect to this context. All calls on the returned menu model
|
|
(and linked models) must also originate from this same context, with
|
|
the thread default main context unchanged.
|
|
|
|
This call is non-blocking. The returned action group may or may not
|
|
already be filled in. The correct thing to do is connect the signals
|
|
for the action group to monitor for changes and then to call
|
|
g_action_group_list_actions() to get the initial list.</doc>
|
|
<source-position filename="gdbusactiongroup.h" line="48"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14975">a #GDBusActionGroup</doc>
|
|
<type name="DBusActionGroup" c:type="GDBusActionGroup*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14956">A #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="bus_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14957">the bus name which exports the action
|
|
group or %NULL if @connection is not a message bus connection</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14959">the object path at which the action group is exported</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</class>
|
|
<record name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo" version="2.26" glib:type-name="GDBusAnnotationInfo" glib:get-type="g_dbus_annotation_info_get_type" c:symbol-prefix="dbus_annotation_info">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="32">Information about an annotation.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="50"/>
|
|
<field name="ref_count" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="34">The reference count or -1 if statically allocated.</doc>
|
|
<type name="gint" c:type="volatile gint"/>
|
|
</field>
|
|
<field name="key" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="35">The name of the annotation, e.g. "org.freedesktop.DBus.Deprecated".</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="value" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="36">The value of the annotation.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="annotations" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="37">A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</field>
|
|
<method name="ref" c:identifier="g_dbus_annotation_info_ref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15088">If @info is statically allocated does nothing. Otherwise increases
|
|
the reference count.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="228"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15095">The same @info.</doc>
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15090">A #GDBusNodeInfo</doc>
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_dbus_annotation_info_unref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15100">If @info is statically allocated, does nothing. Otherwise decreases
|
|
the reference count of @info. When its reference count drops to 0,
|
|
the memory used is freed.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="243"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15102">A #GDBusAnnotationInfo.</doc>
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="lookup" c:identifier="g_dbus_annotation_info_lookup" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15074">Looks up the value of an annotation.
|
|
|
|
The cost of this function is O(n) in number of annotations.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="183"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15083">The value or %NULL if not found. Do not free, it is owned by @annotations.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="annotations" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15076">A %NULL-terminated array of annotations or %NULL.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15077">The name of the annotation to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<record name="DBusArgInfo" c:type="GDBusArgInfo" version="2.26" glib:type-name="GDBusArgInfo" glib:get-type="g_dbus_arg_info_get_type" c:symbol-prefix="dbus_arg_info">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="52">Information about an argument for a method or a signal.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="70"/>
|
|
<field name="ref_count" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="54">The reference count or -1 if statically allocated.</doc>
|
|
<type name="gint" c:type="volatile gint"/>
|
|
</field>
|
|
<field name="name" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="55">Name of the argument, e.g. @unix_user_id.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="signature" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="56">D-Bus signature of the argument (a single complete type).</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="annotations" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="57">A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</field>
|
|
<method name="ref" c:identifier="g_dbus_arg_info_ref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15112">If @info is statically allocated does nothing. Otherwise increases
|
|
the reference count.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="226"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15119">The same @info.</doc>
|
|
<type name="DBusArgInfo" c:type="GDBusArgInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15114">A #GDBusArgInfo</doc>
|
|
<type name="DBusArgInfo" c:type="GDBusArgInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_dbus_arg_info_unref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15124">If @info is statically allocated, does nothing. Otherwise decreases
|
|
the reference count of @info. When its reference count drops to 0,
|
|
the memory used is freed.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="241"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15126">A #GDBusArgInfo.</doc>
|
|
<type name="DBusArgInfo" c:type="GDBusArgInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<class name="DBusAuthObserver" c:symbol-prefix="dbus_auth_observer" c:type="GDBusAuthObserver" version="2.26" parent="GObject.Object" glib:type-name="GDBusAuthObserver" glib:get-type="g_dbus_auth_observer_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5455">The #GDBusAuthObserver type provides a mechanism for participating
|
|
in how a #GDBusServer (or a #GDBusConnection) authenticates remote
|
|
peers. Simply instantiate a #GDBusAuthObserver and connect to the
|
|
signals you are interested in. Note that new signals may be added
|
|
in the future
|
|
|
|
## Controlling Authentication Mechanisms
|
|
|
|
By default, a #GDBusServer or server-side #GDBusConnection will allow
|
|
any authentication mechanism to be used. If you only
|
|
want to allow D-Bus connections with the `EXTERNAL` mechanism,
|
|
which makes use of credentials passing and is the recommended
|
|
mechanism for modern Unix platforms such as Linux and the BSD family,
|
|
you would use a signal handler like this:
|
|
|
|
|[<!-- language="C" -->
|
|
static gboolean
|
|
on_allow_mechanism (GDBusAuthObserver *observer,
|
|
const gchar *mechanism,
|
|
gpointer user_data)
|
|
{
|
|
if (g_strcmp0 (mechanism, "EXTERNAL") == 0)
|
|
{
|
|
return TRUE;
|
|
}
|
|
|
|
return FALSE;
|
|
}
|
|
]|
|
|
|
|
## Controlling Authorization # {#auth-observer}
|
|
|
|
By default, a #GDBusServer or server-side #GDBusConnection will accept
|
|
connections from any successfully authenticated user (but not from
|
|
anonymous connections using the `ANONYMOUS` mechanism). If you only
|
|
want to allow D-Bus connections from processes owned by the same uid
|
|
as the server, you would use a signal handler like the following:
|
|
|
|
|[<!-- language="C" -->
|
|
static gboolean
|
|
on_authorize_authenticated_peer (GDBusAuthObserver *observer,
|
|
GIOStream *stream,
|
|
GCredentials *credentials,
|
|
gpointer user_data)
|
|
{
|
|
gboolean authorized;
|
|
|
|
authorized = FALSE;
|
|
if (credentials != NULL)
|
|
{
|
|
GCredentials *own_credentials;
|
|
own_credentials = g_credentials_new ();
|
|
if (g_credentials_is_same_user (credentials, own_credentials, NULL))
|
|
authorized = TRUE;
|
|
g_object_unref (own_credentials);
|
|
}
|
|
|
|
return authorized;
|
|
}
|
|
]|</doc>
|
|
<constructor name="new" c:identifier="g_dbus_auth_observer_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15161">Creates a new #GDBusAuthObserver object.</doc>
|
|
<source-position filename="gdbusauthobserver.h" line="39"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15166">A #GDBusAuthObserver. Free with g_object_unref().</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="allow_mechanism" c:identifier="g_dbus_auth_observer_allow_mechanism" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15136">Emits the #GDBusAuthObserver::allow-mechanism signal on @observer.</doc>
|
|
<source-position filename="gdbusauthobserver.h" line="46"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15143">%TRUE if @mechanism can be used to authenticate the other peer, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="observer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15138">A #GDBusAuthObserver.</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</instance-parameter>
|
|
<parameter name="mechanism" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15139">The name of the mechanism, e.g. `DBUS_COOKIE_SHA1`.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="authorize_authenticated_peer" c:identifier="g_dbus_auth_observer_authorize_authenticated_peer" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15148">Emits the #GDBusAuthObserver::authorize-authenticated-peer signal on @observer.</doc>
|
|
<source-position filename="gdbusauthobserver.h" line="41"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15156">%TRUE if the peer is authorized, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="observer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15150">A #GDBusAuthObserver.</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</instance-parameter>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15151">A #GIOStream for the #GDBusConnection.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="credentials" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15152">Credentials received from the peer or %NULL.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="allow-mechanism" when="last" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="597">Emitted to check if @mechanism is allowed to be used.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="604">%TRUE if @mechanism can be used to authenticate the other peer, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mechanism" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="600">The name of the mechanism, e.g. `DBUS_COOKIE_SHA1`.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="authorize-authenticated-peer" when="last" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="609">Emitted to check if a peer that is successfully authenticated
|
|
is authorized.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="618">%TRUE if the peer is authorized, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="612">A #GIOStream for the #GDBusConnection.</doc>
|
|
<type name="IOStream"/>
|
|
</parameter>
|
|
<parameter name="credentials" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="613">Credentials received from the peer or %NULL.</doc>
|
|
<type name="Credentials"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<bitfield name="DBusCallFlags" version="2.26" glib:type-name="GDBusCallFlags" glib:get-type="g_dbus_call_flags_get_type" c:type="GDBusCallFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1236">Flags used in g_dbus_connection_call() and similar APIs.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_CALL_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1238">No flags set.</doc>
|
|
</member>
|
|
<member name="no_auto_start" value="1" c:identifier="G_DBUS_CALL_FLAGS_NO_AUTO_START" glib:nick="no-auto-start">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1239">The bus must not launch
|
|
an owner for the destination name in response to this method
|
|
invocation.</doc>
|
|
</member>
|
|
<member name="allow_interactive_authorization" value="2" c:identifier="G_DBUS_CALL_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION" glib:nick="allow-interactive-authorization">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1242">the caller is prepared to
|
|
wait for interactive authorization. Since 2.46.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<bitfield name="DBusCapabilityFlags" version="2.26" glib:type-name="GDBusCapabilityFlags" glib:get-type="g_dbus_capability_flags_get_type" c:type="GDBusCapabilityFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1221">Capabilities negotiated with the remote peer.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_CAPABILITY_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1223">No flags set.</doc>
|
|
</member>
|
|
<member name="unix_fd_passing" value="1" c:identifier="G_DBUS_CAPABILITY_FLAGS_UNIX_FD_PASSING" glib:nick="unix-fd-passing">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1224">The connection
|
|
supports exchanging UNIX file descriptors with the remote peer.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<class name="DBusConnection" c:symbol-prefix="dbus_connection" c:type="GDBusConnection" version="2.26" parent="GObject.Object" glib:type-name="GDBusConnection" glib:get-type="g_dbus_connection_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5523">The #GDBusConnection type is used for D-Bus connections to remote
|
|
peers such as a message buses. It is a low-level API that offers a
|
|
lot of flexibility. For instance, it lets you establish a connection
|
|
over any transport that can by represented as a #GIOStream.
|
|
|
|
This class is rarely used directly in D-Bus clients. If you are writing
|
|
a D-Bus client, it is often easier to use the g_bus_own_name(),
|
|
g_bus_watch_name() or g_dbus_proxy_new_for_bus() APIs.
|
|
|
|
As an exception to the usual GLib rule that a particular object must not
|
|
be used by two threads at the same time, #GDBusConnection's methods may be
|
|
called from any thread. This is so that g_bus_get() and g_bus_get_sync()
|
|
can safely return the same #GDBusConnection when called from any thread.
|
|
|
|
Most of the ways to obtain a #GDBusConnection automatically initialize it
|
|
(i.e. connect to D-Bus): for instance, g_dbus_connection_new() and
|
|
g_bus_get(), and the synchronous versions of those methods, give you an
|
|
initialized connection. Language bindings for GIO should use
|
|
g_initable_new() or g_async_initable_new_async(), which also initialize the
|
|
connection.
|
|
|
|
If you construct an uninitialized #GDBusConnection, such as via
|
|
g_object_new(), you must initialize it via g_initable_init() or
|
|
g_async_initable_init_async() before using its methods or properties.
|
|
Calling methods or accessing properties on a #GDBusConnection that has not
|
|
completed initialization successfully is considered to be invalid, and leads
|
|
to undefined behaviour. In particular, if initialization fails with a
|
|
#GError, the only valid thing you can do with that #GDBusConnection is to
|
|
free it with g_object_unref().
|
|
|
|
## An example D-Bus server # {#gdbus-server}
|
|
|
|
Here is an example for a D-Bus server:
|
|
[gdbus-example-server.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-server.c)
|
|
|
|
## An example for exporting a subtree # {#gdbus-subtree-server}
|
|
|
|
Here is an example for exporting a subtree:
|
|
[gdbus-example-subtree.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-subtree.c)
|
|
|
|
## An example for file descriptor passing # {#gdbus-unix-fd-client}
|
|
|
|
Here is an example for passing UNIX file descriptors:
|
|
[gdbus-unix-fd-client.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-unix-fd-client.c)
|
|
|
|
## An example for exporting a GObject # {#gdbus-export}
|
|
|
|
Here is an example for exporting a #GObject:
|
|
[gdbus-example-export.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-export.c)</doc>
|
|
<implements name="AsyncInitable"/>
|
|
<implements name="Initable"/>
|
|
<constructor name="new_finish" c:identifier="g_dbus_connection_new_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15801">Finishes an operation started with g_dbus_connection_new().</doc>
|
|
<source-position filename="gdbusconnection.h" line="65"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15809">a #GDBusConnection or %NULL if @error is set. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15803">a #GAsyncResult obtained from the #GAsyncReadyCallback
|
|
passed to g_dbus_connection_new().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_for_address_finish" c:identifier="g_dbus_connection_new_for_address_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15850">Finishes an operation started with g_dbus_connection_new_for_address().</doc>
|
|
<source-position filename="gdbusconnection.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15858">a #GDBusConnection or %NULL if @error is set. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15852">a #GAsyncResult obtained from the #GAsyncReadyCallback passed
|
|
to g_dbus_connection_new()</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_for_address_sync" c:identifier="g_dbus_connection_new_for_address_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15864">Synchronously connects and sets up a D-Bus client connection for
|
|
exchanging D-Bus messages with an endpoint specified by @address
|
|
which must be in the
|
|
[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
|
|
|
|
This constructor can only be used to initiate client-side
|
|
connections - use g_dbus_connection_new_sync() if you need to act
|
|
as the server. In particular, @flags cannot contain the
|
|
%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
|
|
%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
|
|
|
|
This is a synchronous failable constructor. See
|
|
g_dbus_connection_new_for_address() for the asynchronous version.
|
|
|
|
If @observer is not %NULL it may be used to control the
|
|
authentication process.</doc>
|
|
<source-position filename="gdbusconnection.h" line="86"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15889">a #GDBusConnection or %NULL if @error is set. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15866">a D-Bus address</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15867">flags describing how to make the connection</doc>
|
|
<type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
|
|
</parameter>
|
|
<parameter name="observer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15868">a #GDBusAuthObserver or %NULL</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15869">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_sync" c:identifier="g_dbus_connection_new_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15895">Synchronously sets up a D-Bus connection for exchanging D-Bus messages
|
|
with the end represented by @stream.
|
|
|
|
If @stream is a #GSocketConnection, then the corresponding #GSocket
|
|
will be put into non-blocking mode.
|
|
|
|
The D-Bus connection will interact with @stream from a worker thread.
|
|
As a result, the caller should not interact with @stream after this
|
|
method has been called, except by calling g_object_unref() on it.
|
|
|
|
If @observer is not %NULL it may be used to control the
|
|
authentication process.
|
|
|
|
This is a synchronous failable constructor. See
|
|
g_dbus_connection_new() for the asynchronous version.</doc>
|
|
<source-position filename="gdbusconnection.h" line="68"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15920">a #GDBusConnection or %NULL if @error is set. Free with g_object_unref().</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15897">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="guid" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15898">the GUID to use if a authenticating as a server or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15899">flags describing how to make the connection</doc>
|
|
<type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
|
|
</parameter>
|
|
<parameter name="observer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15900">a #GDBusAuthObserver or %NULL</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15901">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="new" c:identifier="g_dbus_connection_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15766">Asynchronously sets up a D-Bus connection for exchanging D-Bus messages
|
|
with the end represented by @stream.
|
|
|
|
If @stream is a #GSocketConnection, then the corresponding #GSocket
|
|
will be put into non-blocking mode.
|
|
|
|
The D-Bus connection will interact with @stream from a worker thread.
|
|
As a result, the caller should not interact with @stream after this
|
|
method has been called, except by calling g_object_unref() on it.
|
|
|
|
If @observer is not %NULL it may be used to control the
|
|
authentication process.
|
|
|
|
When the operation is finished, @callback will be invoked. You can
|
|
then call g_dbus_connection_new_finish() to get the result of the
|
|
operation.
|
|
|
|
This is an asynchronous failable constructor. See
|
|
g_dbus_connection_new_sync() for the synchronous
|
|
version.</doc>
|
|
<source-position filename="gdbusconnection.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15768">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="guid" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15769">the GUID to use if a authenticating as a server or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15770">flags describing how to make the connection</doc>
|
|
<type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
|
|
</parameter>
|
|
<parameter name="observer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15771">a #GDBusAuthObserver or %NULL</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15772">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15773">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15774">the data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_address" c:identifier="g_dbus_connection_new_for_address" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15815">Asynchronously connects and sets up a D-Bus client connection for
|
|
exchanging D-Bus messages with an endpoint specified by @address
|
|
which must be in the
|
|
[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
|
|
|
|
This constructor can only be used to initiate client-side
|
|
connections - use g_dbus_connection_new() if you need to act as the
|
|
server. In particular, @flags cannot contain the
|
|
%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER or
|
|
%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS flags.
|
|
|
|
When the operation is finished, @callback will be invoked. You can
|
|
then call g_dbus_connection_new_for_address_finish() to get the result of
|
|
the operation.
|
|
|
|
If @observer is not %NULL it may be used to control the
|
|
authentication process.
|
|
|
|
This is an asynchronous failable constructor. See
|
|
g_dbus_connection_new_for_address_sync() for the synchronous
|
|
version.</doc>
|
|
<source-position filename="gdbusconnection.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15817">a D-Bus address</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15818">flags describing how to make the connection</doc>
|
|
<type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
|
|
</parameter>
|
|
<parameter name="observer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15819">a #GDBusAuthObserver or %NULL</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15820">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15821">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15822">the data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="add_filter" c:identifier="g_dbus_connection_add_filter" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15171">Adds a message filter. Filters are handlers that are run on all
|
|
incoming and outgoing messages, prior to standard dispatch. Filters
|
|
are run in the order that they were added. The same handler can be
|
|
added as a filter more than once, in which case it will be run more
|
|
than once. Filters added during a filter callback won't be run on
|
|
the message being processed. Filter functions are allowed to modify
|
|
and even drop messages.
|
|
|
|
Note that filters are run in a dedicated message handling thread so
|
|
they can't block and, generally, can't do anything but signal a
|
|
worker thread. Also note that filters are rarely needed - use API
|
|
such as g_dbus_connection_send_message_with_reply(),
|
|
g_dbus_connection_signal_subscribe() or g_dbus_connection_call() instead.
|
|
|
|
If a filter consumes an incoming message the message is not
|
|
dispatched anywhere else - not even the standard dispatch machinery
|
|
(that API such as g_dbus_connection_signal_subscribe() and
|
|
g_dbus_connection_send_message_with_reply() relies on) will see the
|
|
message. Similarly, if a filter consumes an outgoing message, the
|
|
message will not be sent to the other peer.
|
|
|
|
If @user_data_free_func is non-%NULL, it will be called (in the
|
|
thread-default main context of the thread you are calling this
|
|
method from) at some point after @user_data is no longer
|
|
needed. (It is not guaranteed to be called synchronously when the
|
|
filter is removed, and may be called after @connection has been
|
|
destroyed.)</doc>
|
|
<source-position filename="gdbusconnection.h" line="669"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15207">a filter identifier that can be used with
|
|
g_dbus_connection_remove_filter()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15173">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="filter_function" transfer-ownership="none" scope="notified" closure="1" destroy="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15174">a filter function</doc>
|
|
<type name="DBusMessageFilterFunction" c:type="GDBusMessageFilterFunction"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15175">user data to pass to @filter_function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15176">function to free @user_data with when filter
|
|
is removed or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call" c:identifier="g_dbus_connection_call" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15213">Asynchronously invokes the @method_name method on the
|
|
@interface_name D-Bus interface on the remote object at
|
|
@object_path owned by @bus_name.
|
|
|
|
If @connection is closed then the operation will fail with
|
|
%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
|
|
fail with %G_IO_ERROR_CANCELLED. If @parameters contains a value
|
|
not compatible with the D-Bus protocol, the operation fails with
|
|
%G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
If @reply_type is non-%NULL then the reply will be checked for having this type and an
|
|
error will be raised if it does not match. Said another way, if you give a @reply_type
|
|
then any non-%NULL return value will be of this type. Unless it’s
|
|
%G_VARIANT_TYPE_UNIT, the @reply_type will be a tuple containing one or more
|
|
values.
|
|
|
|
If the @parameters #GVariant is floating, it is consumed. This allows
|
|
convenient 'inline' use of g_variant_new(), e.g.:
|
|
|[<!-- language="C" -->
|
|
g_dbus_connection_call (connection,
|
|
"org.freedesktop.StringThings",
|
|
"/org/freedesktop/StringThings",
|
|
"org.freedesktop.StringThings",
|
|
"TwoStrings",
|
|
g_variant_new ("(ss)",
|
|
"Thing One",
|
|
"Thing Two"),
|
|
NULL,
|
|
G_DBUS_CALL_FLAGS_NONE,
|
|
-1,
|
|
NULL,
|
|
(GAsyncReadyCallback) two_strings_done,
|
|
NULL);
|
|
]|
|
|
|
|
This is an asynchronous method. When the operation is finished,
|
|
@callback will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from. You can then call
|
|
g_dbus_connection_call_finish() to get the result of the operation.
|
|
See g_dbus_connection_call_sync() for the synchronous version of this
|
|
function.
|
|
|
|
If @callback is %NULL then the D-Bus method call message will be sent with
|
|
the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set.</doc>
|
|
<source-position filename="gdbusconnection.h" line="193"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15215">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="bus_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15216">a unique or well-known bus name or %NULL if
|
|
@connection is not a message bus connection</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15218">path of remote object</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15219">D-Bus interface to invoke method on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15220">the name of the method to invoke</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15221">a #GVariant tuple with parameters for the method
|
|
or %NULL if not passing parameters</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="reply_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15223">the expected type of the reply (which will be a
|
|
tuple), or %NULL</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15225">flags from the #GDBusCallFlags enumeration</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15226">the timeout in milliseconds, -1 to use the default
|
|
timeout or %G_MAXINT for no timeout</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15228">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="10">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15229">a #GAsyncReadyCallback to call when the request
|
|
is satisfied or %NULL if you don't care about the result of the
|
|
method invocation</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15232">the data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_finish" c:identifier="g_dbus_connection_call_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15284">Finishes an operation started with g_dbus_connection_call().</doc>
|
|
<source-position filename="gdbusconnection.h" line="206"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15292">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15286">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15287">a #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_connection_call()</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_sync" c:identifier="g_dbus_connection_call_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15298">Synchronously invokes the @method_name method on the
|
|
@interface_name D-Bus interface on the remote object at
|
|
@object_path owned by @bus_name.
|
|
|
|
If @connection is closed then the operation will fail with
|
|
%G_IO_ERROR_CLOSED. If @cancellable is canceled, the
|
|
operation will fail with %G_IO_ERROR_CANCELLED. If @parameters
|
|
contains a value not compatible with the D-Bus protocol, the operation
|
|
fails with %G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
If @reply_type is non-%NULL then the reply will be checked for having
|
|
this type and an error will be raised if it does not match. Said
|
|
another way, if you give a @reply_type then any non-%NULL return
|
|
value will be of this type.
|
|
|
|
If the @parameters #GVariant is floating, it is consumed.
|
|
This allows convenient 'inline' use of g_variant_new(), e.g.:
|
|
|[<!-- language="C" -->
|
|
g_dbus_connection_call_sync (connection,
|
|
"org.freedesktop.StringThings",
|
|
"/org/freedesktop/StringThings",
|
|
"org.freedesktop.StringThings",
|
|
"TwoStrings",
|
|
g_variant_new ("(ss)",
|
|
"Thing One",
|
|
"Thing Two"),
|
|
NULL,
|
|
G_DBUS_CALL_FLAGS_NONE,
|
|
-1,
|
|
NULL,
|
|
&error);
|
|
]|
|
|
|
|
The calling thread is blocked until a reply is received. See
|
|
g_dbus_connection_call() for the asynchronous version of
|
|
this method.</doc>
|
|
<source-position filename="gdbusconnection.h" line="210"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15352">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15300">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="bus_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15301">a unique or well-known bus name or %NULL if
|
|
@connection is not a message bus connection</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15303">path of remote object</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15304">D-Bus interface to invoke method on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15305">the name of the method to invoke</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15306">a #GVariant tuple with parameters for the method
|
|
or %NULL if not passing parameters</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="reply_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15308">the expected type of the reply, or %NULL</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15309">flags from the #GDBusCallFlags enumeration</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15310">the timeout in milliseconds, -1 to use the default
|
|
timeout or %G_MAXINT for no timeout</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15312">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_with_unix_fd_list" c:identifier="g_dbus_connection_call_with_unix_fd_list" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15358">Like g_dbus_connection_call() but also takes a #GUnixFDList object.
|
|
|
|
This method is only available on UNIX.</doc>
|
|
<source-position filename="gdbusconnection.h" line="222"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15360">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="bus_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15361">a unique or well-known bus name or %NULL if
|
|
@connection is not a message bus connection</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15363">path of remote object</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15364">D-Bus interface to invoke method on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15365">the name of the method to invoke</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15366">a #GVariant tuple with parameters for the method
|
|
or %NULL if not passing parameters</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="reply_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15368">the expected type of the reply, or %NULL</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15369">flags from the #GDBusCallFlags enumeration</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15370">the timeout in milliseconds, -1 to use the default
|
|
timeout or %G_MAXINT for no timeout</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="fd_list" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15372">a #GUnixFDList or %NULL</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15373">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="11">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15374">a #GAsyncReadyCallback to call when the request is
|
|
satisfied or %NULL if you don't * care about the result of the
|
|
method invocation</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15377">The data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_with_unix_fd_list_finish" c:identifier="g_dbus_connection_call_with_unix_fd_list_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15387">Finishes an operation started with g_dbus_connection_call_with_unix_fd_list().</doc>
|
|
<source-position filename="gdbusconnection.h" line="236"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15397">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15389">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_fd_list" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15390">return location for a #GUnixFDList or %NULL</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList**"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15391">a #GAsyncResult obtained from the #GAsyncReadyCallback passed to
|
|
g_dbus_connection_call_with_unix_fd_list()</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_with_unix_fd_list_sync" c:identifier="g_dbus_connection_call_with_unix_fd_list_sync" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15403">Like g_dbus_connection_call_sync() but also takes and returns #GUnixFDList objects.
|
|
|
|
This method is only available on UNIX.</doc>
|
|
<source-position filename="gdbusconnection.h" line="241"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15426">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15405">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="bus_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15406">a unique or well-known bus name or %NULL
|
|
if @connection is not a message bus connection</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15408">path of remote object</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15409">D-Bus interface to invoke method on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15410">the name of the method to invoke</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15411">a #GVariant tuple with parameters for
|
|
the method or %NULL if not passing parameters</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="reply_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15413">the expected type of the reply, or %NULL</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15414">flags from the #GDBusCallFlags enumeration</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15415">the timeout in milliseconds, -1 to use the default
|
|
timeout or %G_MAXINT for no timeout</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="fd_list" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15417">a #GUnixFDList or %NULL</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</parameter>
|
|
<parameter name="out_fd_list" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15418">return location for a #GUnixFDList or %NULL</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15419">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close" c:identifier="g_dbus_connection_close" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15432">Closes @connection. Note that this never causes the process to
|
|
exit (this might only happen if the other end of a shared message
|
|
bus connection disconnects, see #GDBusConnection:exit-on-close).
|
|
|
|
Once the connection is closed, operations such as sending a message
|
|
will return with the error %G_IO_ERROR_CLOSED. Closing a connection
|
|
will not automatically flush the connection so queued messages may
|
|
be lost. Use g_dbus_connection_flush() if you need such guarantees.
|
|
|
|
If @connection is already closed, this method fails with
|
|
%G_IO_ERROR_CLOSED.
|
|
|
|
When @connection has been closed, the #GDBusConnection::closed
|
|
signal is emitted in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread that @connection was constructed in.
|
|
|
|
This is an asynchronous method. When the operation is finished,
|
|
@callback will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from. You can
|
|
then call g_dbus_connection_close_finish() to get the result of the
|
|
operation. See g_dbus_connection_close_sync() for the synchronous
|
|
version.</doc>
|
|
<source-position filename="gdbusconnection.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15434">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15435">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15436">a #GAsyncReadyCallback to call when the request is
|
|
satisfied or %NULL if you don't care about the result</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15438">The data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_finish" c:identifier="g_dbus_connection_close_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15469">Finishes an operation started with g_dbus_connection_close().</doc>
|
|
<source-position filename="gdbusconnection.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15478">%TRUE if the operation succeeded, %FALSE if @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15471">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15472">a #GAsyncResult obtained from the #GAsyncReadyCallback passed
|
|
to g_dbus_connection_close()</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_sync" c:identifier="g_dbus_connection_close_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15483">Synchronously closes @connection. The calling thread is blocked
|
|
until this is done. See g_dbus_connection_close() for the
|
|
asynchronous version of this method and more details about what it
|
|
does.</doc>
|
|
<source-position filename="gdbusconnection.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15494">%TRUE if the operation succeeded, %FALSE if @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15485">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15486">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="emit_signal" c:identifier="g_dbus_connection_emit_signal" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15499">Emits a signal.
|
|
|
|
If the parameters GVariant is floating, it is consumed.
|
|
|
|
This can only fail if @parameters is not compatible with the D-Bus protocol
|
|
(%G_IO_ERROR_INVALID_ARGUMENT), or if @connection has been closed
|
|
(%G_IO_ERROR_CLOSED).</doc>
|
|
<source-position filename="gdbusconnection.h" line="185"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15519">%TRUE unless @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15501">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination_bus_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15502">the unique bus name for the destination
|
|
for the signal or %NULL to emit to all listeners</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15504">path of remote object</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15505">D-Bus interface to emit a signal on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15506">the name of the signal to emit</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15507">a #GVariant tuple with parameters for the signal
|
|
or %NULL if not passing parameters</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="export_action_group" c:identifier="g_dbus_connection_export_action_group" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15524">Exports @action_group on @connection at @object_path.
|
|
|
|
The implemented D-Bus API should be considered private. It is
|
|
subject to change in the future.
|
|
|
|
A given object path can only have one action group exported on it.
|
|
If this constraint is violated, the export will fail and 0 will be
|
|
returned (with @error set accordingly).
|
|
|
|
You can unexport the action group using
|
|
g_dbus_connection_unexport_action_group() with the return value of
|
|
this function.
|
|
|
|
The thread default main context is taken at the time of this call.
|
|
All incoming action activations and state change requests are
|
|
reported from this context. Any changes on the action group that
|
|
cause it to emit signals must also come from this same context.
|
|
Since incoming action activations and state change requests are
|
|
rather likely to cause changes on the action group, this effectively
|
|
limits a given action group to being exported from only one main
|
|
context.</doc>
|
|
<source-position filename="gactiongroupexporter.h" line="34"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15553">the ID of the export (never zero), or 0 in case of failure</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15526">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15527">a D-Bus object path</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="action_group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15528">a #GActionGroup</doc>
|
|
<type name="ActionGroup" c:type="GActionGroup*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="export_menu_model" c:identifier="g_dbus_connection_export_menu_model" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15558">Exports @menu on @connection at @object_path.
|
|
|
|
The implemented D-Bus API should be considered private.
|
|
It is subject to change in the future.
|
|
|
|
An object path can only have one menu model exported on it. If this
|
|
constraint is violated, the export will fail and 0 will be
|
|
returned (with @error set accordingly).
|
|
|
|
You can unexport the menu model using
|
|
g_dbus_connection_unexport_menu_model() with the return value of
|
|
this function.</doc>
|
|
<source-position filename="gmenuexporter.h" line="29"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15578">the ID of the export (never zero), or 0 in case of failure</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15560">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15561">a D-Bus object path</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15562">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush" c:identifier="g_dbus_connection_flush" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15583">Asynchronously flushes @connection, that is, writes all queued
|
|
outgoing message to the transport and then flushes the transport
|
|
(using g_output_stream_flush_async()). This is useful in programs
|
|
that wants to emit a D-Bus signal and then exit immediately. Without
|
|
flushing the connection, there is no guaranteed that the message has
|
|
been sent to the networking buffers in the OS kernel.
|
|
|
|
This is an asynchronous method. When the operation is finished,
|
|
@callback will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from. You can
|
|
then call g_dbus_connection_flush_finish() to get the result of the
|
|
operation. See g_dbus_connection_flush_sync() for the synchronous
|
|
version.</doc>
|
|
<source-position filename="gdbusconnection.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15585">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15586">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15587">a #GAsyncReadyCallback to call when the
|
|
request is satisfied or %NULL if you don't care about the result</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15589">The data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush_finish" c:identifier="g_dbus_connection_flush_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15610">Finishes an operation started with g_dbus_connection_flush().</doc>
|
|
<source-position filename="gdbusconnection.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15619">%TRUE if the operation succeeded, %FALSE if @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15612">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15613">a #GAsyncResult obtained from the #GAsyncReadyCallback passed
|
|
to g_dbus_connection_flush()</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush_sync" c:identifier="g_dbus_connection_flush_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15624">Synchronously flushes @connection. The calling thread is blocked
|
|
until this is done. See g_dbus_connection_flush() for the
|
|
asynchronous version of this method and more details about what it
|
|
does.</doc>
|
|
<source-position filename="gdbusconnection.h" line="148"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15635">%TRUE if the operation succeeded, %FALSE if @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15626">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15627">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_capabilities" c:identifier="g_dbus_connection_get_capabilities" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15640">Gets the capabilities negotiated with the remote peer</doc>
|
|
<source-position filename="gdbusconnection.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15646">zero or more flags from the #GDBusCapabilityFlags enumeration</doc>
|
|
<type name="DBusCapabilityFlags" c:type="GDBusCapabilityFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15642">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_exit_on_close" c:identifier="g_dbus_connection_get_exit_on_close" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15651">Gets whether the process is terminated when @connection is
|
|
closed by the remote peer. See
|
|
#GDBusConnection:exit-on-close for more details.</doc>
|
|
<source-position filename="gdbusconnection.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15659">whether the process is terminated when @connection is
|
|
closed by the remote peer</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15653">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_dbus_connection_get_flags" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15665">Gets the flags used to construct this connection</doc>
|
|
<source-position filename="gdbusconnection.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15671">zero or more flags from the #GDBusConnectionFlags enumeration</doc>
|
|
<type name="DBusConnectionFlags" c:type="GDBusConnectionFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15667">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_guid" c:identifier="g_dbus_connection_get_guid" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15676">The GUID of the peer performing the role of server when
|
|
authenticating. See #GDBusConnection:guid for more details.</doc>
|
|
<source-position filename="gdbusconnection.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15683">The GUID. Do not free this string, it is owned by
|
|
@connection.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15678">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_last_serial" c:identifier="g_dbus_connection_get_last_serial" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15689">Retrieves the last serial number assigned to a #GDBusMessage on
|
|
the current thread. This includes messages sent via both low-level
|
|
API such as g_dbus_connection_send_message() as well as
|
|
high-level API such as g_dbus_connection_emit_signal(),
|
|
g_dbus_connection_call() or g_dbus_proxy_call().</doc>
|
|
<source-position filename="gdbusconnection.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15699">the last used serial or zero when no message has been sent
|
|
within the current thread</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15691">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_peer_credentials" c:identifier="g_dbus_connection_get_peer_credentials" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15705">Gets the credentials of the authenticated peer. This will always
|
|
return %NULL unless @connection acted as a server
|
|
(e.g. %G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER was passed)
|
|
when set up and the client passed credentials as part of the
|
|
authentication process.
|
|
|
|
In a message bus setup, the message bus is always the server and
|
|
each application is a client. So this method will always return
|
|
%NULL for message bus clients.</doc>
|
|
<source-position filename="gdbusconnection.h" line="105"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15719">a #GCredentials or %NULL if not
|
|
available. Do not free this object, it is owned by @connection.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15707">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_stream" c:identifier="g_dbus_connection_get_stream" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15725">Gets the underlying stream used for IO.
|
|
|
|
While the #GDBusConnection is active, it will interact with this
|
|
stream from a worker thread, so it is not safe to interact with
|
|
the stream directly.</doc>
|
|
<source-position filename="gdbusconnection.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15735">the stream used for IO</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15727">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_unique_name" c:identifier="g_dbus_connection_get_unique_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15740">Gets the unique name of @connection as assigned by the message
|
|
bus. This can also be used to figure out if @connection is a
|
|
message bus connection.</doc>
|
|
<source-position filename="gdbusconnection.h" line="103"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15748">the unique name or %NULL if @connection is not a message
|
|
bus connection. Do not free this string, it is owned by
|
|
@connection.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15742">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_closed" c:identifier="g_dbus_connection_is_closed" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15755">Gets whether @connection is closed.</doc>
|
|
<source-position filename="gdbusconnection.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15761">%TRUE if the connection is closed, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15757">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="register_object" c:identifier="g_dbus_connection_register_object" shadowed-by="register_object_with_closures" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15925">Registers callbacks for exported objects at @object_path with the
|
|
D-Bus interface that is described in @interface_info.
|
|
|
|
Calls to functions in @vtable (and @user_data_free_func) will happen
|
|
in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from.
|
|
|
|
Note that all #GVariant values passed to functions in @vtable will match
|
|
the signature given in @interface_info - if a remote caller passes
|
|
incorrect values, the `org.freedesktop.DBus.Error.InvalidArgs`
|
|
is returned to the remote caller.
|
|
|
|
Additionally, if the remote caller attempts to invoke methods or
|
|
access properties not mentioned in @interface_info the
|
|
`org.freedesktop.DBus.Error.UnknownMethod` resp.
|
|
`org.freedesktop.DBus.Error.InvalidArgs` errors
|
|
are returned to the caller.
|
|
|
|
It is considered a programming error if the
|
|
#GDBusInterfaceGetPropertyFunc function in @vtable returns a
|
|
#GVariant of incorrect type.
|
|
|
|
If an existing callback is already registered at @object_path and
|
|
@interface_name, then @error is set to #G_IO_ERROR_EXISTS.
|
|
|
|
GDBus automatically implements the standard D-Bus interfaces
|
|
org.freedesktop.DBus.Properties, org.freedesktop.DBus.Introspectable
|
|
and org.freedesktop.Peer, so you don't have to implement those for the
|
|
objects you export. You can implement org.freedesktop.DBus.Properties
|
|
yourself, e.g. to handle getting and setting of properties asynchronously.
|
|
|
|
Note that the reference count on @interface_info will be
|
|
incremented by 1 (unless allocated statically, e.g. if the
|
|
reference count is -1, see g_dbus_interface_info_ref()) for as long
|
|
as the object is exported. Also note that @vtable will be copied.
|
|
|
|
See this [server][gdbus-server] for an example of how to use this method.</doc>
|
|
<source-position filename="gdbusconnection.h" line="399"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15974">0 if @error is set, otherwise a registration id (never 0)
|
|
that can be used with g_dbus_connection_unregister_object()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15927">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15928">the object path to register at</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15929">introspection data for the interface</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</parameter>
|
|
<parameter name="vtable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15930">a #GDBusInterfaceVTable to call into or %NULL</doc>
|
|
<type name="DBusInterfaceVTable" c:type="const GDBusInterfaceVTable*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15931">data to pass to functions in @vtable</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15932">function to call when the object path is unregistered</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="register_object_with_closures" c:identifier="g_dbus_connection_register_object_with_closures" shadows="register_object" version="2.46" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15980">Version of g_dbus_connection_register_object() using closures instead of a
|
|
#GDBusInterfaceVTable for easier binding in other languages.</doc>
|
|
<source-position filename="gdbusconnection.h" line="407"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15993">0 if @error is set, otherwise a registration id (never 0)
|
|
that can be used with g_dbus_connection_unregister_object() .</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15982">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15983">The object path to register at.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15984">Introspection data for the interface.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</parameter>
|
|
<parameter name="method_call_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15985">#GClosure for handling incoming method calls.</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
<parameter name="get_property_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15986">#GClosure for getting a property.</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
<parameter name="set_property_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15987">#GClosure for setting a property.</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="register_subtree" c:identifier="g_dbus_connection_register_subtree" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15999">Registers a whole subtree of dynamic objects.
|
|
|
|
The @enumerate and @introspection functions in @vtable are used to
|
|
convey, to remote callers, what nodes exist in the subtree rooted
|
|
by @object_path.
|
|
|
|
When handling remote calls into any node in the subtree, first the
|
|
@enumerate function is used to check if the node exists. If the node exists
|
|
or the #G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is set
|
|
the @introspection function is used to check if the node supports the
|
|
requested method. If so, the @dispatch function is used to determine
|
|
where to dispatch the call. The collected #GDBusInterfaceVTable and
|
|
#gpointer will be used to call into the interface vtable for processing
|
|
the request.
|
|
|
|
All calls into user-provided code will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from.
|
|
|
|
If an existing subtree is already registered at @object_path or
|
|
then @error is set to #G_IO_ERROR_EXISTS.
|
|
|
|
Note that it is valid to register regular objects (using
|
|
g_dbus_connection_register_object()) in a subtree registered with
|
|
g_dbus_connection_register_subtree() - if so, the subtree handler
|
|
is tried as the last resort. One way to think about a subtree
|
|
handler is to consider it a fallback handler for object paths not
|
|
registered via g_dbus_connection_register_object() or other bindings.
|
|
|
|
Note that @vtable will be copied so you cannot change it after
|
|
registration.
|
|
|
|
See this [server][gdbus-subtree-server] for an example of how to use
|
|
this method.</doc>
|
|
<source-position filename="gdbusconnection.h" line="537"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16045">0 if @error is set, otherwise a subtree registration id (never 0)
|
|
that can be used with g_dbus_connection_unregister_subtree() .</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16001">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16002">the object path to register the subtree at</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="vtable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16003">a #GDBusSubtreeVTable to enumerate, introspect and
|
|
dispatch nodes in the subtree</doc>
|
|
<type name="DBusSubtreeVTable" c:type="const GDBusSubtreeVTable*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16005">flags used to fine tune the behavior of the subtree</doc>
|
|
<type name="DBusSubtreeFlags" c:type="GDBusSubtreeFlags"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16006">data to pass to functions in @vtable</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16007">function to call when the subtree is unregistered</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_filter" c:identifier="g_dbus_connection_remove_filter" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16051">Removes a filter.
|
|
|
|
Note that since filters run in a different thread, there is a race
|
|
condition where it is possible that the filter will be running even
|
|
after calling g_dbus_connection_remove_filter(), so you cannot just
|
|
free data that the filter might be using. Instead, you should pass
|
|
a #GDestroyNotify to g_dbus_connection_add_filter(), which will be
|
|
called when it is guaranteed that the data is no longer needed.</doc>
|
|
<source-position filename="gdbusconnection.h" line="675"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16053">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="filter_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16054">an identifier obtained from g_dbus_connection_add_filter()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_message" c:identifier="g_dbus_connection_send_message" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16069">Asynchronously sends @message to the peer represented by @connection.
|
|
|
|
Unless @flags contain the
|
|
%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
|
|
will be assigned by @connection and set on @message via
|
|
g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
|
|
serial number used will be written to this location prior to
|
|
submitting the message to the underlying transport.
|
|
|
|
If @connection is closed then the operation will fail with
|
|
%G_IO_ERROR_CLOSED. If @message is not well-formed,
|
|
the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
|
|
for an example of how to use this low-level API to send and receive
|
|
UNIX file descriptors.
|
|
|
|
Note that @message must be unlocked, unless @flags contain the
|
|
%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.</doc>
|
|
<source-position filename="gdbusconnection.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16098">%TRUE if the message was well-formed and queued for
|
|
transmission, %FALSE if @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16071">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16072">a #GDBusMessage</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16073">flags affecting how the message is sent</doc>
|
|
<type name="DBusSendMessageFlags" c:type="GDBusSendMessageFlags"/>
|
|
</parameter>
|
|
<parameter name="out_serial" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16074">return location for serial number assigned
|
|
to @message when sending it or %NULL</doc>
|
|
<type name="guint32" c:type="volatile guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_message_with_reply" c:identifier="g_dbus_connection_send_message_with_reply" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16104">Asynchronously sends @message to the peer represented by @connection.
|
|
|
|
Unless @flags contain the
|
|
%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
|
|
will be assigned by @connection and set on @message via
|
|
g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
|
|
serial number used will be written to this location prior to
|
|
submitting the message to the underlying transport.
|
|
|
|
If @connection is closed then the operation will fail with
|
|
%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
|
|
fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
|
|
the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
This is an asynchronous method. When the operation is finished, @callback
|
|
will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from. You can then call
|
|
g_dbus_connection_send_message_with_reply_finish() to get the result of the operation.
|
|
See g_dbus_connection_send_message_with_reply_sync() for the synchronous version.
|
|
|
|
Note that @message must be unlocked, unless @flags contain the
|
|
%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.
|
|
|
|
See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
|
|
for an example of how to use this low-level API to send and receive
|
|
UNIX file descriptors.</doc>
|
|
<source-position filename="gdbusconnection.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16106">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16107">a #GDBusMessage</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16108">flags affecting how the message is sent</doc>
|
|
<type name="DBusSendMessageFlags" c:type="GDBusSendMessageFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16109">the timeout in milliseconds, -1 to use the default
|
|
timeout or %G_MAXINT for no timeout</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="out_serial" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16111">return location for serial number assigned
|
|
to @message when sending it or %NULL</doc>
|
|
<type name="guint32" c:type="volatile guint32*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16113">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16114">a #GAsyncReadyCallback to call when the request
|
|
is satisfied or %NULL if you don't care about the result</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16116">The data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_message_with_reply_finish" c:identifier="g_dbus_connection_send_message_with_reply_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16150">Finishes an operation started with g_dbus_connection_send_message_with_reply().
|
|
|
|
Note that @error is only set if a local in-process error
|
|
occurred. That is to say that the returned #GDBusMessage object may
|
|
be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
|
|
g_dbus_message_to_gerror() to transcode this to a #GError.
|
|
|
|
See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
|
|
for an example of how to use this low-level API to send and receive
|
|
UNIX file descriptors.</doc>
|
|
<source-position filename="gdbusconnection.h" line="170"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16168">a locked #GDBusMessage or %NULL if @error is set</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16152">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16153">a #GAsyncResult obtained from the #GAsyncReadyCallback passed to
|
|
g_dbus_connection_send_message_with_reply()</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_message_with_reply_sync" c:identifier="g_dbus_connection_send_message_with_reply_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16173">Synchronously sends @message to the peer represented by @connection
|
|
and blocks the calling thread until a reply is received or the
|
|
timeout is reached. See g_dbus_connection_send_message_with_reply()
|
|
for the asynchronous version of this method.
|
|
|
|
Unless @flags contain the
|
|
%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag, the serial number
|
|
will be assigned by @connection and set on @message via
|
|
g_dbus_message_set_serial(). If @out_serial is not %NULL, then the
|
|
serial number used will be written to this location prior to
|
|
submitting the message to the underlying transport.
|
|
|
|
If @connection is closed then the operation will fail with
|
|
%G_IO_ERROR_CLOSED. If @cancellable is canceled, the operation will
|
|
fail with %G_IO_ERROR_CANCELLED. If @message is not well-formed,
|
|
the operation fails with %G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
Note that @error is only set if a local in-process error
|
|
occurred. That is to say that the returned #GDBusMessage object may
|
|
be of type %G_DBUS_MESSAGE_TYPE_ERROR. Use
|
|
g_dbus_message_to_gerror() to transcode this to a #GError.
|
|
|
|
See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
|
|
for an example of how to use this low-level API to send and receive
|
|
UNIX file descriptors.
|
|
|
|
Note that @message must be unlocked, unless @flags contain the
|
|
%G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL flag.</doc>
|
|
<source-position filename="gdbusconnection.h" line="174"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16214">a locked #GDBusMessage that is the reply
|
|
to @message or %NULL if @error is set</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16175">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16176">a #GDBusMessage</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16177">flags affecting how the message is sent.</doc>
|
|
<type name="DBusSendMessageFlags" c:type="GDBusSendMessageFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16178">the timeout in milliseconds, -1 to use the default
|
|
timeout or %G_MAXINT for no timeout</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="out_serial" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16180">return location for serial number
|
|
assigned to @message when sending it or %NULL</doc>
|
|
<type name="guint32" c:type="volatile guint32*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16182">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_exit_on_close" c:identifier="g_dbus_connection_set_exit_on_close" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16220">Sets whether the process should be terminated when @connection is
|
|
closed by the remote peer. See #GDBusConnection:exit-on-close for
|
|
more details.
|
|
|
|
Note that this function should be used with care. Most modern UNIX
|
|
desktops tie the notion of a user session with the session bus, and expect
|
|
all of a user's applications to quit when their bus connection goes away.
|
|
If you are setting @exit_on_close to %FALSE for the shared session
|
|
bus connection, you should make sure that your application exits
|
|
when the user session ends.</doc>
|
|
<source-position filename="gdbusconnection.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16222">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="exit_on_close" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16223">whether the process should be terminated
|
|
when @connection is closed by the remote peer</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="signal_subscribe" c:identifier="g_dbus_connection_signal_subscribe" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16241">Subscribes to signals on @connection and invokes @callback with a whenever
|
|
the signal is received. Note that @callback will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from.
|
|
|
|
If @connection is not a message bus connection, @sender must be
|
|
%NULL.
|
|
|
|
If @sender is a well-known name note that @callback is invoked with
|
|
the unique name for the owner of @sender, not the well-known name
|
|
as one would expect. This is because the message bus rewrites the
|
|
name. As such, to avoid certain race conditions, users should be
|
|
tracking the name owner of the well-known name and use that when
|
|
processing the received signal.
|
|
|
|
If one of %G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE or
|
|
%G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_PATH are given, @arg0 is
|
|
interpreted as part of a namespace or path. The first argument
|
|
of a signal is matched against that part as specified by D-Bus.
|
|
|
|
If @user_data_free_func is non-%NULL, it will be called (in the
|
|
thread-default main context of the thread you are calling this
|
|
method from) at some point after @user_data is no longer
|
|
needed. (It is not guaranteed to be called synchronously when the
|
|
signal is unsubscribed from, and may be called after @connection
|
|
has been destroyed.)
|
|
|
|
The returned subscription identifier is an opaque value which is guaranteed
|
|
to never be zero.
|
|
|
|
This function can never fail.</doc>
|
|
<source-position filename="gdbusconnection.h" line="573"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16293">a subscription identifier that can be used with g_dbus_connection_signal_unsubscribe()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16243">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="sender" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16244">sender name to match on (unique or well-known name)
|
|
or %NULL to listen from all senders</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16246">D-Bus interface name to match on or %NULL to
|
|
match on all interfaces</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="member" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16248">D-Bus signal name to match on or %NULL to match on
|
|
all signals</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16250">object path to match on or %NULL to match on
|
|
all object paths</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="arg0" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16252">contents of first string argument to match on or %NULL
|
|
to match on all kinds of arguments</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16254">#GDBusSignalFlags describing how arg0 is used in subscribing to the
|
|
signal</doc>
|
|
<type name="DBusSignalFlags" c:type="GDBusSignalFlags"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" scope="notified" closure="7" destroy="8">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16256">callback to invoke when there is a signal matching the requested data</doc>
|
|
<type name="DBusSignalCallback" c:type="GDBusSignalCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16257">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16258">function to free @user_data with when
|
|
subscription is removed or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="signal_unsubscribe" c:identifier="g_dbus_connection_signal_unsubscribe" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16298">Unsubscribes from signals.</doc>
|
|
<source-position filename="gdbusconnection.h" line="584"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16300">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="subscription_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16301">a subscription id obtained from
|
|
g_dbus_connection_signal_subscribe()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start_message_processing" c:identifier="g_dbus_connection_start_message_processing" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16310">If @connection was created with
|
|
%G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING, this method
|
|
starts processing messages. Does nothing on if @connection wasn't
|
|
created with this flag or if the method has already been called.</doc>
|
|
<source-position filename="gdbusconnection.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16312">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unexport_action_group" c:identifier="g_dbus_connection_unexport_action_group" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16323">Reverses the effect of a previous call to
|
|
g_dbus_connection_export_action_group().
|
|
|
|
It is an error to call this function with an ID that wasn't returned
|
|
from g_dbus_connection_export_action_group() or to call it with the
|
|
same ID more than once.</doc>
|
|
<source-position filename="gactiongroupexporter.h" line="40"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16325">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="export_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16326">the ID from g_dbus_connection_export_action_group()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unexport_menu_model" c:identifier="g_dbus_connection_unexport_menu_model" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16339">Reverses the effect of a previous call to
|
|
g_dbus_connection_export_menu_model().
|
|
|
|
It is an error to call this function with an ID that wasn't returned
|
|
from g_dbus_connection_export_menu_model() or to call it with the
|
|
same ID more than once.</doc>
|
|
<source-position filename="gmenuexporter.h" line="35"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16341">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="export_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16342">the ID from g_dbus_connection_export_menu_model()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unregister_object" c:identifier="g_dbus_connection_unregister_object" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16355">Unregisters an object.</doc>
|
|
<source-position filename="gdbusconnection.h" line="415"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16363">%TRUE if the object was unregistered, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16357">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="registration_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16358">a registration id obtained from
|
|
g_dbus_connection_register_object()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unregister_subtree" c:identifier="g_dbus_connection_unregister_subtree" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16368">Unregisters a subtree.</doc>
|
|
<source-position filename="gdbusconnection.h" line="545"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16376">%TRUE if the subtree was unregistered, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16370">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="registration_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16371">a subtree registration id obtained from
|
|
g_dbus_connection_register_subtree()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="address" version="2.26" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="671">A D-Bus address specifying potential endpoints that can be used
|
|
when establishing the connection.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="authentication-observer" version="2.26" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="681">A #GDBusAuthObserver object to assist in the authentication process or %NULL.</doc>
|
|
<type name="DBusAuthObserver"/>
|
|
</property>
|
|
<property name="capabilities" version="2.26" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="690">Flags from the #GDBusCapabilityFlags enumeration
|
|
representing connection features negotiated with the other peer.</doc>
|
|
<type name="DBusCapabilityFlags"/>
|
|
</property>
|
|
<property name="closed" version="2.26" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="700">A boolean specifying whether the connection has been closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="exit-on-close" version="2.26" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="709">A boolean specifying whether the process will be terminated (by
|
|
calling `raise(SIGTERM)`) if the connection is closed by the
|
|
remote peer.
|
|
|
|
Note that #GDBusConnection objects returned by g_bus_get_finish()
|
|
and g_bus_get_sync() will (usually) have this property set to %TRUE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="flags" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="723">Flags from the #GDBusConnectionFlags enumeration.</doc>
|
|
<type name="DBusConnectionFlags"/>
|
|
</property>
|
|
<property name="guid" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="732">The GUID of the peer performing the role of server when
|
|
authenticating.
|
|
|
|
If you are constructing a #GDBusConnection and pass
|
|
%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER in the
|
|
#GDBusConnection:flags property then you MUST also set this
|
|
property to a valid guid.
|
|
|
|
If you are constructing a #GDBusConnection and pass
|
|
%G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT in the
|
|
#GDBusConnection:flags property you will be able to read the GUID
|
|
of the other peer here after the connection has been successfully
|
|
initialized.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="stream" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="762">The underlying #GIOStream used for I/O.
|
|
|
|
If this is passed on construction and is a #GSocketConnection,
|
|
then the corresponding #GSocket will be put into non-blocking mode.
|
|
|
|
While the #GDBusConnection is active, it will interact with this
|
|
stream from a worker thread, so it is not safe to interact with
|
|
the stream directly.</doc>
|
|
<type name="IOStream"/>
|
|
</property>
|
|
<property name="unique-name" version="2.26" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="778">The unique name as assigned by the message bus or %NULL if the
|
|
connection is not open or not a message bus connection.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<glib:signal name="closed" when="last" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="643">Emitted when the connection is closed.
|
|
|
|
The cause of this event can be
|
|
|
|
- If g_dbus_connection_close() is called. In this case
|
|
@remote_peer_vanished is set to %FALSE and @error is %NULL.
|
|
|
|
- If the remote peer closes the connection. In this case
|
|
@remote_peer_vanished is set to %TRUE and @error is set.
|
|
|
|
- If the remote peer sends invalid or malformed data. In this
|
|
case @remote_peer_vanished is set to %FALSE and @error is set.
|
|
|
|
Upon receiving this signal, you should give up your reference to
|
|
@connection. You are guaranteed that this signal is emitted only
|
|
once.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="remote_peer_vanished" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="646">%TRUE if @connection is closed because the
|
|
remote peer closed its end of the connection</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="648">a #GError with more details about the event or %NULL</doc>
|
|
<type name="GLib.Error"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<bitfield name="DBusConnectionFlags" version="2.26" glib:type-name="GDBusConnectionFlags" glib:get-type="g_dbus_connection_flags_get_type" c:type="GDBusConnectionFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1195">Flags used when creating a new #GDBusConnection.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_CONNECTION_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1197">No flags set.</doc>
|
|
</member>
|
|
<member name="authentication_client" value="1" c:identifier="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_CLIENT" glib:nick="authentication-client">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1198">Perform authentication against server.</doc>
|
|
</member>
|
|
<member name="authentication_server" value="2" c:identifier="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_SERVER" glib:nick="authentication-server">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1199">Perform authentication against client.</doc>
|
|
</member>
|
|
<member name="authentication_allow_anonymous" value="4" c:identifier="G_DBUS_CONNECTION_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS" glib:nick="authentication-allow-anonymous">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1200">When
|
|
authenticating as a server, allow the anonymous authentication
|
|
method.</doc>
|
|
</member>
|
|
<member name="message_bus_connection" value="8" c:identifier="G_DBUS_CONNECTION_FLAGS_MESSAGE_BUS_CONNECTION" glib:nick="message-bus-connection">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1203">Pass this flag if connecting to a peer that is a
|
|
message bus. This means that the Hello() method will be invoked as part of the connection setup.</doc>
|
|
</member>
|
|
<member name="delay_message_processing" value="16" c:identifier="G_DBUS_CONNECTION_FLAGS_DELAY_MESSAGE_PROCESSING" glib:nick="delay-message-processing">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1205">If set, processing of D-Bus messages is
|
|
delayed until g_dbus_connection_start_message_processing() is called.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<enumeration name="DBusError" version="2.26" glib:type-name="GDBusError" glib:get-type="g_dbus_error_get_type" c:type="GDBusError" glib:error-domain="g-dbus-error-quark">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1037">Error codes for the %G_DBUS_ERROR error domain.</doc>
|
|
<member name="failed" value="0" c:identifier="G_DBUS_ERROR_FAILED" glib:nick="failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1039">A generic error; "something went wrong" - see the error message for
|
|
more.</doc>
|
|
</member>
|
|
<member name="no_memory" value="1" c:identifier="G_DBUS_ERROR_NO_MEMORY" glib:nick="no-memory">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1042">There was not enough memory to complete an operation.</doc>
|
|
</member>
|
|
<member name="service_unknown" value="2" c:identifier="G_DBUS_ERROR_SERVICE_UNKNOWN" glib:nick="service-unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1044">The bus doesn't know how to launch a service to supply the bus name
|
|
you wanted.</doc>
|
|
</member>
|
|
<member name="name_has_no_owner" value="3" c:identifier="G_DBUS_ERROR_NAME_HAS_NO_OWNER" glib:nick="name-has-no-owner">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1047">The bus name you referenced doesn't exist (i.e. no application owns
|
|
it).</doc>
|
|
</member>
|
|
<member name="no_reply" value="4" c:identifier="G_DBUS_ERROR_NO_REPLY" glib:nick="no-reply">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1050">No reply to a message expecting one, usually means a timeout occurred.</doc>
|
|
</member>
|
|
<member name="io_error" value="5" c:identifier="G_DBUS_ERROR_IO_ERROR" glib:nick="io-error">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1052">Something went wrong reading or writing to a socket, for example.</doc>
|
|
</member>
|
|
<member name="bad_address" value="6" c:identifier="G_DBUS_ERROR_BAD_ADDRESS" glib:nick="bad-address">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1054">A D-Bus bus address was malformed.</doc>
|
|
</member>
|
|
<member name="not_supported" value="7" c:identifier="G_DBUS_ERROR_NOT_SUPPORTED" glib:nick="not-supported">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1056">Requested operation isn't supported (like ENOSYS on UNIX).</doc>
|
|
</member>
|
|
<member name="limits_exceeded" value="8" c:identifier="G_DBUS_ERROR_LIMITS_EXCEEDED" glib:nick="limits-exceeded">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1058">Some limited resource is exhausted.</doc>
|
|
</member>
|
|
<member name="access_denied" value="9" c:identifier="G_DBUS_ERROR_ACCESS_DENIED" glib:nick="access-denied">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1060">Security restrictions don't allow doing what you're trying to do.</doc>
|
|
</member>
|
|
<member name="auth_failed" value="10" c:identifier="G_DBUS_ERROR_AUTH_FAILED" glib:nick="auth-failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1062">Authentication didn't work.</doc>
|
|
</member>
|
|
<member name="no_server" value="11" c:identifier="G_DBUS_ERROR_NO_SERVER" glib:nick="no-server">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1064">Unable to connect to server (probably caused by ECONNREFUSED on a
|
|
socket).</doc>
|
|
</member>
|
|
<member name="timeout" value="12" c:identifier="G_DBUS_ERROR_TIMEOUT" glib:nick="timeout">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1067">Certain timeout errors, possibly ETIMEDOUT on a socket. Note that
|
|
%G_DBUS_ERROR_NO_REPLY is used for message reply timeouts. Warning:
|
|
this is confusingly-named given that %G_DBUS_ERROR_TIMED_OUT also
|
|
exists. We can't fix it for compatibility reasons so just be
|
|
careful.</doc>
|
|
</member>
|
|
<member name="no_network" value="13" c:identifier="G_DBUS_ERROR_NO_NETWORK" glib:nick="no-network">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1073">No network access (probably ENETUNREACH on a socket).</doc>
|
|
</member>
|
|
<member name="address_in_use" value="14" c:identifier="G_DBUS_ERROR_ADDRESS_IN_USE" glib:nick="address-in-use">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1075">Can't bind a socket since its address is in use (i.e. EADDRINUSE).</doc>
|
|
</member>
|
|
<member name="disconnected" value="15" c:identifier="G_DBUS_ERROR_DISCONNECTED" glib:nick="disconnected">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1077">The connection is disconnected and you're trying to use it.</doc>
|
|
</member>
|
|
<member name="invalid_args" value="16" c:identifier="G_DBUS_ERROR_INVALID_ARGS" glib:nick="invalid-args">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1079">Invalid arguments passed to a method call.</doc>
|
|
</member>
|
|
<member name="file_not_found" value="17" c:identifier="G_DBUS_ERROR_FILE_NOT_FOUND" glib:nick="file-not-found">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1081">Missing file.</doc>
|
|
</member>
|
|
<member name="file_exists" value="18" c:identifier="G_DBUS_ERROR_FILE_EXISTS" glib:nick="file-exists">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1083">Existing file and the operation you're using does not silently overwrite.</doc>
|
|
</member>
|
|
<member name="unknown_method" value="19" c:identifier="G_DBUS_ERROR_UNKNOWN_METHOD" glib:nick="unknown-method">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1085">Method name you invoked isn't known by the object you invoked it on.</doc>
|
|
</member>
|
|
<member name="timed_out" value="20" c:identifier="G_DBUS_ERROR_TIMED_OUT" glib:nick="timed-out">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1095">Certain timeout errors, e.g. while starting a service. Warning: this is
|
|
confusingly-named given that %G_DBUS_ERROR_TIMEOUT also exists. We
|
|
can't fix it for compatibility reasons so just be careful.</doc>
|
|
</member>
|
|
<member name="match_rule_not_found" value="21" c:identifier="G_DBUS_ERROR_MATCH_RULE_NOT_FOUND" glib:nick="match-rule-not-found">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1099">Tried to remove or modify a match rule that didn't exist.</doc>
|
|
</member>
|
|
<member name="match_rule_invalid" value="22" c:identifier="G_DBUS_ERROR_MATCH_RULE_INVALID" glib:nick="match-rule-invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1101">The match rule isn't syntactically valid.</doc>
|
|
</member>
|
|
<member name="spawn_exec_failed" value="23" c:identifier="G_DBUS_ERROR_SPAWN_EXEC_FAILED" glib:nick="spawn-exec-failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1103">While starting a new process, the exec() call failed.</doc>
|
|
</member>
|
|
<member name="spawn_fork_failed" value="24" c:identifier="G_DBUS_ERROR_SPAWN_FORK_FAILED" glib:nick="spawn-fork-failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1105">While starting a new process, the fork() call failed.</doc>
|
|
</member>
|
|
<member name="spawn_child_exited" value="25" c:identifier="G_DBUS_ERROR_SPAWN_CHILD_EXITED" glib:nick="spawn-child-exited">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1107">While starting a new process, the child exited with a status code.</doc>
|
|
</member>
|
|
<member name="spawn_child_signaled" value="26" c:identifier="G_DBUS_ERROR_SPAWN_CHILD_SIGNALED" glib:nick="spawn-child-signaled">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1109">While starting a new process, the child exited on a signal.</doc>
|
|
</member>
|
|
<member name="spawn_failed" value="27" c:identifier="G_DBUS_ERROR_SPAWN_FAILED" glib:nick="spawn-failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1111">While starting a new process, something went wrong.</doc>
|
|
</member>
|
|
<member name="spawn_setup_failed" value="28" c:identifier="G_DBUS_ERROR_SPAWN_SETUP_FAILED" glib:nick="spawn-setup-failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1113">We failed to setup the environment correctly.</doc>
|
|
</member>
|
|
<member name="spawn_config_invalid" value="29" c:identifier="G_DBUS_ERROR_SPAWN_CONFIG_INVALID" glib:nick="spawn-config-invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1115">We failed to setup the config parser correctly.</doc>
|
|
</member>
|
|
<member name="spawn_service_invalid" value="30" c:identifier="G_DBUS_ERROR_SPAWN_SERVICE_INVALID" glib:nick="spawn-service-invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1117">Bus name was not valid.</doc>
|
|
</member>
|
|
<member name="spawn_service_not_found" value="31" c:identifier="G_DBUS_ERROR_SPAWN_SERVICE_NOT_FOUND" glib:nick="spawn-service-not-found">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1119">Service file not found in system-services directory.</doc>
|
|
</member>
|
|
<member name="spawn_permissions_invalid" value="32" c:identifier="G_DBUS_ERROR_SPAWN_PERMISSIONS_INVALID" glib:nick="spawn-permissions-invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1121">Permissions are incorrect on the setuid helper.</doc>
|
|
</member>
|
|
<member name="spawn_file_invalid" value="33" c:identifier="G_DBUS_ERROR_SPAWN_FILE_INVALID" glib:nick="spawn-file-invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1123">Service file invalid (Name, User or Exec missing).</doc>
|
|
</member>
|
|
<member name="spawn_no_memory" value="34" c:identifier="G_DBUS_ERROR_SPAWN_NO_MEMORY" glib:nick="spawn-no-memory">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1125">Tried to get a UNIX process ID and it wasn't available.</doc>
|
|
</member>
|
|
<member name="unix_process_id_unknown" value="35" c:identifier="G_DBUS_ERROR_UNIX_PROCESS_ID_UNKNOWN" glib:nick="unix-process-id-unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1127">Tried to get a UNIX process ID and it wasn't available.</doc>
|
|
</member>
|
|
<member name="invalid_signature" value="36" c:identifier="G_DBUS_ERROR_INVALID_SIGNATURE" glib:nick="invalid-signature">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1129">A type signature is not valid.</doc>
|
|
</member>
|
|
<member name="invalid_file_content" value="37" c:identifier="G_DBUS_ERROR_INVALID_FILE_CONTENT" glib:nick="invalid-file-content">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1131">A file contains invalid syntax or is otherwise broken.</doc>
|
|
</member>
|
|
<member name="selinux_security_context_unknown" value="38" c:identifier="G_DBUS_ERROR_SELINUX_SECURITY_CONTEXT_UNKNOWN" glib:nick="selinux-security-context-unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1133">Asked for SELinux security context and it wasn't available.</doc>
|
|
</member>
|
|
<member name="adt_audit_data_unknown" value="39" c:identifier="G_DBUS_ERROR_ADT_AUDIT_DATA_UNKNOWN" glib:nick="adt-audit-data-unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1135">Asked for ADT audit data and it wasn't available.</doc>
|
|
</member>
|
|
<member name="object_path_in_use" value="40" c:identifier="G_DBUS_ERROR_OBJECT_PATH_IN_USE" glib:nick="object-path-in-use">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1137">There's already an object with the requested object path.</doc>
|
|
</member>
|
|
<member name="unknown_object" value="41" c:identifier="G_DBUS_ERROR_UNKNOWN_OBJECT" glib:nick="unknown-object">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1087">Object you invoked a method on isn't known. Since 2.42</doc>
|
|
</member>
|
|
<member name="unknown_interface" value="42" c:identifier="G_DBUS_ERROR_UNKNOWN_INTERFACE" glib:nick="unknown-interface">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1089">Interface you invoked a method on isn't known by the object. Since 2.42</doc>
|
|
</member>
|
|
<member name="unknown_property" value="43" c:identifier="G_DBUS_ERROR_UNKNOWN_PROPERTY" glib:nick="unknown-property">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1091">Property you tried to access isn't known by the object. Since 2.42</doc>
|
|
</member>
|
|
<member name="property_read_only" value="44" c:identifier="G_DBUS_ERROR_PROPERTY_READ_ONLY" glib:nick="property-read-only">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1093">Property you tried to set is read-only. Since 2.42</doc>
|
|
</member>
|
|
<function name="encode_gerror" c:identifier="g_dbus_error_encode_gerror" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16381">Creates a D-Bus error name to use for @error. If @error matches
|
|
a registered error (cf. g_dbus_error_register_error()), the corresponding
|
|
D-Bus error name will be returned.
|
|
|
|
Otherwise the a name of the form
|
|
`org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE`
|
|
will be used. This allows other GDBus applications to map the error
|
|
on the wire back to a #GError using g_dbus_error_new_for_dbus_error().
|
|
|
|
This function is typically only used in object mappings to put a
|
|
#GError on the wire. Regular applications should not use it.</doc>
|
|
<source-position filename="gdbuserror.h" line="105"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16397">A D-Bus error name (never %NULL). Free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16383">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_remote_error" c:identifier="g_dbus_error_get_remote_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16402">Gets the D-Bus error name used for @error, if any.
|
|
|
|
This function is guaranteed to return a D-Bus error name for all
|
|
#GErrors returned from functions handling remote method calls
|
|
(e.g. g_dbus_connection_call_finish()) unless
|
|
g_dbus_error_strip_remote_error() has been used on @error.</doc>
|
|
<source-position filename="gdbuserror.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16413">an allocated string or %NULL if the D-Bus error name
|
|
could not be found. Free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16404">a #GError</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="is_remote_error" c:identifier="g_dbus_error_is_remote_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16419">Checks if @error represents an error received via D-Bus from a remote peer. If so,
|
|
use g_dbus_error_get_remote_error() to get the name of the error.</doc>
|
|
<source-position filename="gdbuserror.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16426">%TRUE if @error represents an error from a remote peer,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16421">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_dbus_error" c:identifier="g_dbus_error_new_for_dbus_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16432">Creates a #GError based on the contents of @dbus_error_name and
|
|
@dbus_error_message.
|
|
|
|
Errors registered with g_dbus_error_register_error() will be looked
|
|
up using @dbus_error_name and if a match is found, the error domain
|
|
and code is used. Applications can use g_dbus_error_get_remote_error()
|
|
to recover @dbus_error_name.
|
|
|
|
If a match against a registered error is not found and the D-Bus
|
|
error name is in a form as returned by g_dbus_error_encode_gerror()
|
|
the error domain and code encoded in the name is used to
|
|
create the #GError. Also, @dbus_error_name is added to the error message
|
|
such that it can be recovered with g_dbus_error_get_remote_error().
|
|
|
|
Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR
|
|
in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is
|
|
added to the error message such that it can be recovered with
|
|
g_dbus_error_get_remote_error().
|
|
|
|
In all three cases, @dbus_error_name can always be recovered from the
|
|
returned #GError using the g_dbus_error_get_remote_error() function
|
|
(unless g_dbus_error_strip_remote_error() hasn't been used on the returned error).
|
|
|
|
This function is typically only used in object mappings to prepare
|
|
#GError instances for applications. Regular applications should not use
|
|
it.</doc>
|
|
<source-position filename="gdbuserror.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16464">An allocated #GError. Free with g_error_free().</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16434">D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16435">D-Bus error message.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="quark" c:identifier="g_dbus_error_quark">
|
|
<return-value transfer-ownership="none">
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="register_error" c:identifier="g_dbus_error_register_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16469">Creates an association to map between @dbus_error_name and
|
|
#GErrors specified by @error_domain and @error_code.
|
|
|
|
This is typically done in the routine that returns the #GQuark for
|
|
an error domain.</doc>
|
|
<source-position filename="gdbuserror.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16481">%TRUE if the association was created, %FALSE if it already
|
|
exists.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error_domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16471">A #GQuark for a error domain.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="error_code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16472">An error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16473">A D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="register_error_domain" c:identifier="g_dbus_error_register_error_domain" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16487">Helper function for associating a #GError error domain with D-Bus error names.</doc>
|
|
<source-position filename="gdbuserror.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error_domain_quark_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16489">The error domain name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="quark_volatile" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16490">A pointer where to store the #GQuark.</doc>
|
|
<type name="gsize" c:type="volatile gsize*"/>
|
|
</parameter>
|
|
<parameter name="entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16491">A pointer to @num_entries #GDBusErrorEntry struct items.</doc>
|
|
<array length="3" zero-terminated="0" c:type="const GDBusErrorEntry*">
|
|
<type name="DBusErrorEntry" c:type="GDBusErrorEntry"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16492">Number of items to register.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="set_dbus_error" c:identifier="g_dbus_error_set_dbus_error" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16500">Does nothing if @error is %NULL. Otherwise sets *@error to
|
|
a new #GError created with g_dbus_error_new_for_dbus_error()
|
|
with @dbus_error_message prepend with @format (unless %NULL).</doc>
|
|
<source-position filename="gdbuserror.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16502">A pointer to a #GError or %NULL.</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16503">D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16504">D-Bus error message.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16505">printf()-style format to prepend to @dbus_error_message or %NULL.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16506">Arguments for @format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="set_dbus_error_valist" c:identifier="g_dbus_error_set_dbus_error_valist" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16516">Like g_dbus_error_set_dbus_error() but intended for language bindings.</doc>
|
|
<source-position filename="gdbuserror.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16518">A pointer to a #GError or %NULL.</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16519">D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16520">D-Bus error message.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16521">printf()-style format to prepend to @dbus_error_message or %NULL.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="var_args" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16522">Arguments for @format.</doc>
|
|
<type name="va_list" c:type="va_list"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="strip_remote_error" c:identifier="g_dbus_error_strip_remote_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16530">Looks for extra information in the error message used to recover
|
|
the D-Bus error name and strips it if found. If stripped, the
|
|
message field in @error will correspond exactly to what was
|
|
received on the wire.
|
|
|
|
This is typically used when presenting errors to the end user.</doc>
|
|
<source-position filename="gdbuserror.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16541">%TRUE if information was stripped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16532">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unregister_error" c:identifier="g_dbus_error_unregister_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16546">Destroys an association previously set up with g_dbus_error_register_error().</doc>
|
|
<source-position filename="gdbuserror.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16554">%TRUE if the association was destroyed, %FALSE if it wasn't found.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error_domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16548">A #GQuark for a error domain.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="error_code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16549">An error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16550">A D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</enumeration>
|
|
<record name="DBusErrorEntry" c:type="GDBusErrorEntry" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbuserror.h" line="59">Struct used in g_dbus_error_register_error_domain().</doc>
|
|
<source-position filename="gdbuserror.h" line="72"/>
|
|
<field name="error_code" writable="1">
|
|
<doc xml:space="preserve" filename="gdbuserror.h" line="61">An error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</field>
|
|
<field name="dbus_error_name" writable="1">
|
|
<doc xml:space="preserve" filename="gdbuserror.h" line="62">The D-Bus error name to associate with @error_code.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</field>
|
|
</record>
|
|
<interface name="DBusInterface" c:symbol-prefix="dbus_interface" c:type="GDBusInterface" version="2.30" glib:type-name="GDBusInterface" glib:get-type="g_dbus_interface_get_type" glib:type-struct="DBusInterfaceIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5657">The #GDBusInterface type is the base type for D-Bus interfaces both
|
|
on the service side (see #GDBusInterfaceSkeleton) and client side
|
|
(see #GDBusProxy).</doc>
|
|
<source-position filename="gdbusinterface.h" line="65"/>
|
|
<virtual-method name="dup_object" invoker="dup_object" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16635">Gets the #GDBusObject that @interface_ belongs to, if any.</doc>
|
|
<source-position filename="gdbusinterface.h" line="64"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16641">A #GDBusObject or %NULL. The returned
|
|
reference should be freed with g_object_unref().</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16637">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_info" invoker="get_info" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16647">Gets D-Bus introspection information for the D-Bus interface
|
|
implemented by @interface_.</doc>
|
|
<source-position filename="gdbusinterface.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16654">A #GDBusInterfaceInfo. Do not free.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16649">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_object" invoker="get_object" version="2.30" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16659">Gets the #GDBusObject that @interface_ belongs to, if any.
|
|
|
|
It is not safe to use the returned object if @interface_ or
|
|
the returned object is being used from other threads. See
|
|
g_dbus_interface_dup_object() for a thread-safe alternative.</doc>
|
|
<source-position filename="gdbusinterface.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16669">A #GDBusObject or %NULL. The returned
|
|
reference belongs to @interface_ and should not be freed.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16661">An exported D-Bus interface</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_object" invoker="set_object" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16792">Sets the #GDBusObject for @interface_ to @object.
|
|
|
|
Note that @interface_ will hold a weak reference to @object.</doc>
|
|
<source-position filename="gdbusinterface.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16794">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16795">A #GDBusObject or %NULL.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="dup_object" c:identifier="g_dbus_interface_dup_object" shadows="get_object" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16635">Gets the #GDBusObject that @interface_ belongs to, if any.</doc>
|
|
<source-position filename="gdbusinterface.h" line="77"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16641">A #GDBusObject or %NULL. The returned
|
|
reference should be freed with g_object_unref().</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16637">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_info" c:identifier="g_dbus_interface_get_info" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16647">Gets D-Bus introspection information for the D-Bus interface
|
|
implemented by @interface_.</doc>
|
|
<source-position filename="gdbusinterface.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16654">A #GDBusInterfaceInfo. Do not free.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16649">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object" c:identifier="g_dbus_interface_get_object" shadowed-by="dup_object" version="2.30" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16659">Gets the #GDBusObject that @interface_ belongs to, if any.
|
|
|
|
It is not safe to use the returned object if @interface_ or
|
|
the returned object is being used from other threads. See
|
|
g_dbus_interface_dup_object() for a thread-safe alternative.</doc>
|
|
<source-position filename="gdbusinterface.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16669">A #GDBusObject or %NULL. The returned
|
|
reference belongs to @interface_ and should not be freed.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16661">An exported D-Bus interface</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_object" c:identifier="g_dbus_interface_set_object" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16792">Sets the #GDBusObject for @interface_ to @object.
|
|
|
|
Note that @interface_ will hold a weak reference to @object.</doc>
|
|
<source-position filename="gdbusinterface.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16794">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16795">A #GDBusObject or %NULL.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<callback name="DBusInterfaceGetPropertyFunc" c:type="GDBusInterfaceGetPropertyFunc" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="282">The type of the @get_property function in #GDBusInterfaceVTable.</doc>
|
|
<source-position filename="gdbusconnection.h" line="300"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="294">A #GVariant with the value for @property_name or %NULL if
|
|
@error is set. If the returned #GVariant is floating, it is
|
|
consumed - otherwise its reference count is decreased by one.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="284">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="sender" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="285">The unique bus name of the remote caller.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="286">The object path that the method was invoked on.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="287">The D-Bus interface name for the property.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="property_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="288">The name of the property to get the value of.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="289">Return location for error.</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="290">The @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="DBusInterfaceIface" c:type="GDBusInterfaceIface" glib:is-gtype-struct-for="DBusInterface" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusinterface.h" line="43">Base type for D-Bus interfaces.</doc>
|
|
<source-position filename="gdbusinterface.h" line="65"/>
|
|
<field name="parent_iface">
|
|
<doc xml:space="preserve" filename="gdbusinterface.h" line="45">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_info">
|
|
<callback name="get_info">
|
|
<source-position filename="gdbusinterface.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16654">A #GDBusInterfaceInfo. Do not free.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16649">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_object">
|
|
<callback name="get_object">
|
|
<source-position filename="gdbusinterface.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16669">A #GDBusObject or %NULL. The returned
|
|
reference belongs to @interface_ and should not be freed.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16661">An exported D-Bus interface</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_object">
|
|
<callback name="set_object">
|
|
<source-position filename="gdbusinterface.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16794">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16795">A #GDBusObject or %NULL.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="dup_object">
|
|
<callback name="dup_object">
|
|
<source-position filename="gdbusinterface.h" line="64"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16641">A #GDBusObject or %NULL. The returned
|
|
reference should be freed with g_object_unref().</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16637">An exported D-Bus interface.</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo" version="2.26" glib:type-name="GDBusInterfaceInfo" glib:get-type="g_dbus_interface_info_get_type" c:symbol-prefix="dbus_interface_info">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="136">Information about a D-Bus interface.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="158"/>
|
|
<field name="ref_count" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="138">The reference count or -1 if statically allocated.</doc>
|
|
<type name="gint" c:type="volatile gint"/>
|
|
</field>
|
|
<field name="name" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="139">The name of the D-Bus interface, e.g. "org.freedesktop.DBus.Properties".</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="methods" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="140">A pointer to a %NULL-terminated array of pointers to #GDBusMethodInfo structures or %NULL if there are no methods.</doc>
|
|
<array c:type="GDBusMethodInfo**">
|
|
<type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="signals" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="141">A pointer to a %NULL-terminated array of pointers to #GDBusSignalInfo structures or %NULL if there are no signals.</doc>
|
|
<array c:type="GDBusSignalInfo**">
|
|
<type name="DBusSignalInfo" c:type="GDBusSignalInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="properties" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="142">A pointer to a %NULL-terminated array of pointers to #GDBusPropertyInfo structures or %NULL if there are no properties.</doc>
|
|
<array c:type="GDBusPropertyInfo**">
|
|
<type name="DBusPropertyInfo" c:type="GDBusPropertyInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="annotations" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="143">A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</field>
|
|
<method name="cache_build" c:identifier="g_dbus_interface_info_cache_build" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16675">Builds a lookup-cache to speed up
|
|
g_dbus_interface_info_lookup_method(),
|
|
g_dbus_interface_info_lookup_signal() and
|
|
g_dbus_interface_info_lookup_property().
|
|
|
|
If this has already been called with @info, the existing cache is
|
|
used and its use count is increased.
|
|
|
|
Note that @info cannot be modified until
|
|
g_dbus_interface_info_cache_release() is called.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="195"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16677">A #GDBusInterfaceInfo.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="cache_release" c:identifier="g_dbus_interface_info_cache_release" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16694">Decrements the usage count for the cache for @info built by
|
|
g_dbus_interface_info_cache_build() (if any) and frees the
|
|
resources used by the cache if the usage count drops to zero.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="197"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16696">A GDBusInterfaceInfo</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="generate_xml" c:identifier="g_dbus_interface_info_generate_xml" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16706">Appends an XML representation of @info (and its children) to @string_builder.
|
|
|
|
This function is typically used for generating introspection XML
|
|
documents at run-time for handling the
|
|
`org.freedesktop.DBus.Introspectable.Introspect`
|
|
method.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="200"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16708">A #GDBusNodeInfo</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="indent" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16709">Indentation level.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="string_builder" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16710">A #GString to to append XML data to.</doc>
|
|
<type name="GLib.String" c:type="GString*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_method" c:identifier="g_dbus_interface_info_lookup_method" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16723">Looks up information about a method.
|
|
|
|
The cost of this function is O(n) in number of methods unless
|
|
g_dbus_interface_info_cache_build() has been used on @info.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="186"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16733">A #GDBusMethodInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
|
|
<type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16725">A #GDBusInterfaceInfo.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16726">A D-Bus method name (typically in CamelCase)</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_property" c:identifier="g_dbus_interface_info_lookup_property" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16738">Looks up information about a property.
|
|
|
|
The cost of this function is O(n) in number of properties unless
|
|
g_dbus_interface_info_cache_build() has been used on @info.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="192"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16748">A #GDBusPropertyInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
|
|
<type name="DBusPropertyInfo" c:type="GDBusPropertyInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16740">A #GDBusInterfaceInfo.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16741">A D-Bus property name (typically in CamelCase).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_signal" c:identifier="g_dbus_interface_info_lookup_signal" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16753">Looks up information about a signal.
|
|
|
|
The cost of this function is O(n) in number of signals unless
|
|
g_dbus_interface_info_cache_build() has been used on @info.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="189"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16763">A #GDBusSignalInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
|
|
<type name="DBusSignalInfo" c:type="GDBusSignalInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16755">A #GDBusInterfaceInfo.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16756">A D-Bus signal name (typically in CamelCase)</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_dbus_interface_info_ref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16768">If @info is statically allocated does nothing. Otherwise increases
|
|
the reference count.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="218"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16775">The same @info.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16770">A #GDBusInterfaceInfo</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_dbus_interface_info_unref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16780">If @info is statically allocated, does nothing. Otherwise decreases
|
|
the reference count of @info. When its reference count drops to 0,
|
|
the memory used is freed.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="233"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16782">A #GDBusInterfaceInfo.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<callback name="DBusInterfaceMethodCallFunc" c:type="GDBusInterfaceMethodCallFunc" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="258">The type of the @method_call function in #GDBusInterfaceVTable.</doc>
|
|
<source-position filename="gdbusconnection.h" line="273"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="260">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="sender" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="261">The unique bus name of the remote caller.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="262">The object path that the method was invoked on.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="263">The D-Bus interface name the method was invoked on.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="264">The name of the method that was invoked.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="265">A #GVariant tuple with parameters.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="266">A #GDBusMethodInvocation object that must be used to return a value or error.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="267">The @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="DBusInterfaceSetPropertyFunc" c:type="GDBusInterfaceSetPropertyFunc" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="308">The type of the @set_property function in #GDBusInterfaceVTable.</doc>
|
|
<source-position filename="gdbusconnection.h" line="325"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="321">%TRUE if the property was set to @value, %FALSE if @error is set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="310">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="sender" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="311">The unique bus name of the remote caller.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="312">The object path that the method was invoked on.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="313">The D-Bus interface name for the property.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="property_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="314">The name of the property to get the value of.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="315">The value to set the property to.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="316">Return location for error.</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="317">The @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="DBusInterfaceSkeleton" c:symbol-prefix="dbus_interface_skeleton" c:type="GDBusInterfaceSkeleton" version="2.30" parent="GObject.Object" abstract="1" glib:type-name="GDBusInterfaceSkeleton" glib:get-type="g_dbus_interface_skeleton_get_type" glib:type-struct="DBusInterfaceSkeletonClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5668">Abstract base class for D-Bus interfaces on the service side.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="86"/>
|
|
<implements name="DBusInterface"/>
|
|
<virtual-method name="flush" invoker="flush" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16826">If @interface_ has outstanding changes, request for these changes to be
|
|
emitted immediately.
|
|
|
|
For example, an exported D-Bus interface may queue up property
|
|
changes and emit the
|
|
`org.freedesktop.DBus.Properties.PropertiesChanged`
|
|
signal later (e.g. in an idle handler). This technique is useful
|
|
for collapsing multiple property changes into one.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16828">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="g_authorize_method">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="invocation" transfer-ownership="none">
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_info" invoker="get_info" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16881">Gets D-Bus introspection information for the D-Bus interface
|
|
implemented by @interface_.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16888">A #GDBusInterfaceInfo (never %NULL). Do not free.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16883">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_properties" invoker="get_properties" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16905">Gets all D-Bus properties for @interface_.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16911">A #GVariant of type
|
|
['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS].
|
|
Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16907">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_vtable" invoker="get_vtable" version="2.30" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16918">Gets the interface vtable for the D-Bus interface implemented by
|
|
@interface_. The returned function pointers should expect @interface_
|
|
itself to be passed as @user_data.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="72"/>
|
|
<return-value>
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16926">A #GDBusInterfaceVTable (never %NULL).</doc>
|
|
<type name="DBusInterfaceVTable" c:type="GDBusInterfaceVTable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16920">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="export" c:identifier="g_dbus_interface_skeleton_export" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16805">Exports @interface_ at @object_path on @connection.
|
|
|
|
This can be called multiple times to export the same @interface_
|
|
onto multiple connections however the @object_path provided must be
|
|
the same for all connections.
|
|
|
|
Use g_dbus_interface_skeleton_unexport() to unexport the object.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16820">%TRUE if the interface was exported on @connection, otherwise %FALSE with
|
|
@error set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16807">The D-Bus interface to export.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16808">A #GDBusConnection to export @interface_ on.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16809">The path to export the interface at.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush" c:identifier="g_dbus_interface_skeleton_flush" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16826">If @interface_ has outstanding changes, request for these changes to be
|
|
emitted immediately.
|
|
|
|
For example, an exported D-Bus interface may queue up property
|
|
changes and emit the
|
|
`org.freedesktop.DBus.Properties.PropertiesChanged`
|
|
signal later (e.g. in an idle handler). This technique is useful
|
|
for collapsing multiple property changes into one.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16828">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_connection" c:identifier="g_dbus_interface_skeleton_get_connection" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16843">Gets the first connection that @interface_ is exported on, if any.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16849">A #GDBusConnection or %NULL if @interface_ is
|
|
not exported anywhere. Do not free, the object belongs to @interface_.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16845">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_connections" c:identifier="g_dbus_interface_skeleton_get_connections" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16855">Gets a list of the connections that @interface_ is exported on.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="118"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16861">A list of
|
|
all the connections that @interface_ is exported on. The returned
|
|
list should be freed with g_list_free() after each element has
|
|
been freed with g_object_unref().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DBusConnection"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16857">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_dbus_interface_skeleton_get_flags" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16869">Gets the #GDBusInterfaceSkeletonFlags that describes what the behavior
|
|
of @interface_</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16876">One or more flags from the #GDBusInterfaceSkeletonFlags enumeration.</doc>
|
|
<type name="DBusInterfaceSkeletonFlags" c:type="GDBusInterfaceSkeletonFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16871">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_info" c:identifier="g_dbus_interface_skeleton_get_info" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16881">Gets D-Bus introspection information for the D-Bus interface
|
|
implemented by @interface_.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16888">A #GDBusInterfaceInfo (never %NULL). Do not free.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16883">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object_path" c:identifier="g_dbus_interface_skeleton_get_object_path" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16893">Gets the object path that @interface_ is exported on, if any.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16899">A string owned by @interface_ or %NULL if @interface_ is not exported
|
|
anywhere. Do not free, the string belongs to @interface_.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16895">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_properties" c:identifier="g_dbus_interface_skeleton_get_properties" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16905">Gets all D-Bus properties for @interface_.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="100"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16911">A #GVariant of type
|
|
['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS].
|
|
Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16907">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_vtable" c:identifier="g_dbus_interface_skeleton_get_vtable" version="2.30" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16918">Gets the interface vtable for the D-Bus interface implemented by
|
|
@interface_. The returned function pointers should expect @interface_
|
|
itself to be passed as @user_data.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="98"/>
|
|
<return-value>
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16926">A #GDBusInterfaceVTable (never %NULL).</doc>
|
|
<type name="DBusInterfaceVTable" c:type="GDBusInterfaceVTable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16920">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_connection" c:identifier="g_dbus_interface_skeleton_has_connection" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16931">Checks if @interface_ is exported on @connection.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16938">%TRUE if @interface_ is exported on @connection, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16933">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16934">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flags" c:identifier="g_dbus_interface_skeleton_set_flags" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16943">Sets flags describing what the behavior of @skeleton should be.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16945">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16946">Flags from the #GDBusInterfaceSkeletonFlags enumeration.</doc>
|
|
<type name="DBusInterfaceSkeletonFlags" c:type="GDBusInterfaceSkeletonFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unexport" c:identifier="g_dbus_interface_skeleton_unexport" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16954">Stops exporting @interface_ on all connections it is exported on.
|
|
|
|
To unexport @interface_ from only a single connection, use
|
|
g_dbus_interface_skeleton_unexport_from_connection()</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16956">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unexport_from_connection" c:identifier="g_dbus_interface_skeleton_unexport_from_connection" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16967">Stops exporting @interface_ on @connection.
|
|
|
|
To stop exporting on all connections the interface is exported on,
|
|
use g_dbus_interface_skeleton_unexport().</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16969">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16970">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="g-flags" version="2.30" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="842">Flags from the #GDBusInterfaceSkeletonFlags enumeration.</doc>
|
|
<type name="DBusInterfaceSkeletonFlags"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DBusInterfaceSkeletonPrivate" c:type="GDBusInterfaceSkeletonPrivate*"/>
|
|
</field>
|
|
<glib:signal name="g-authorize-method" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="798">Emitted when a method is invoked by a remote caller and used to
|
|
determine if the method call is authorized.
|
|
|
|
Note that this signal is emitted in a thread dedicated to
|
|
handling the method call so handlers are allowed to perform
|
|
blocking IO. This means that it is appropriate to call e.g.
|
|
[polkit_authority_check_authorization_sync()](http://hal.freedesktop.org/docs/polkit/PolkitAuthority.html#polkit-authority-check-authorization-sync)
|
|
with the
|
|
[POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION](http://hal.freedesktop.org/docs/polkit/PolkitAuthority.html#POLKIT-CHECK-AUTHORIZATION-FLAGS-ALLOW-USER-INTERACTION:CAPS)
|
|
flag set.
|
|
|
|
If %FALSE is returned then no further handlers are run and the
|
|
signal handler must take a reference to @invocation and finish
|
|
handling the call (e.g. return an error via
|
|
g_dbus_method_invocation_return_error()).
|
|
|
|
Otherwise, if %TRUE is returned, signal emission continues. If no
|
|
handlers return %FALSE, then the method is dispatched. If
|
|
@interface has an enclosing #GDBusObjectSkeleton, then the
|
|
#GDBusObjectSkeleton::authorize-method signal handlers run before
|
|
the handlers for this signal.
|
|
|
|
The default class handler just returns %TRUE.
|
|
|
|
Please note that the common case is optimized: if no signals
|
|
handlers are connected and the default class handler isn't
|
|
overridden (for both @interface and the enclosing
|
|
#GDBusObjectSkeleton, if any) and #GDBusInterfaceSkeleton:g-flags does
|
|
not have the
|
|
%G_DBUS_INTERFACE_SKELETON_FLAGS_HANDLE_METHOD_INVOCATIONS_IN_THREAD
|
|
flags set, no dedicated thread is ever used and the call will be
|
|
handled in the same thread as the object that @interface belongs
|
|
to was exported in.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="837">%TRUE if the call is authorized, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="801">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="DBusInterfaceSkeletonClass" c:type="GDBusInterfaceSkeletonClass" glib:is-gtype-struct-for="DBusInterfaceSkeleton" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusinterfaceskeleton.h" line="53">Class structure for #GDBusInterfaceSkeleton.</doc>
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="86"/>
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve" filename="gdbusinterfaceskeleton.h" line="55">The parent class.</doc>
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_info">
|
|
<callback name="get_info">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16888">A #GDBusInterfaceInfo (never %NULL). Do not free.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16883">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_vtable" introspectable="0">
|
|
<callback name="get_vtable" introspectable="0">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="72"/>
|
|
<return-value>
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16926">A #GDBusInterfaceVTable (never %NULL).</doc>
|
|
<type name="DBusInterfaceVTable" c:type="GDBusInterfaceVTable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16920">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_properties">
|
|
<callback name="get_properties">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16911">A #GVariant of type
|
|
['a{sv}'][G-VARIANT-TYPE-VARDICT:CAPS].
|
|
Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16907">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="flush">
|
|
<callback name="flush">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16828">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="vfunc_padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
<field name="g_authorize_method">
|
|
<callback name="g_authorize_method">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
<parameter name="invocation" transfer-ownership="none">
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="signal_padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<bitfield name="DBusInterfaceSkeletonFlags" version="2.30" glib:type-name="GDBusInterfaceSkeletonFlags" glib:get-type="g_dbus_interface_skeleton_flags_get_type" c:type="GDBusInterfaceSkeletonFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1675">Flags describing the behavior of a #GDBusInterfaceSkeleton instance.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_INTERFACE_SKELETON_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1677">No flags set.</doc>
|
|
</member>
|
|
<member name="handle_method_invocations_in_thread" value="1" c:identifier="G_DBUS_INTERFACE_SKELETON_FLAGS_HANDLE_METHOD_INVOCATIONS_IN_THREAD" glib:nick="handle-method-invocations-in-thread">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1678">Each method invocation is handled in
|
|
a thread dedicated to the invocation. This means that the method implementation can use blocking IO
|
|
without blocking any other part of the process. It also means that the method implementation must
|
|
use locking to access data structures used by other threads.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="DBusInterfaceSkeletonPrivate" c:type="GDBusInterfaceSkeletonPrivate" disguised="1">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="36"/>
|
|
</record>
|
|
<record name="DBusInterfaceVTable" c:type="GDBusInterfaceVTable" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="334">Virtual table for handling properties and method calls for a D-Bus
|
|
interface.
|
|
|
|
Since 2.38, if you want to handle getting/setting D-Bus properties
|
|
asynchronously, give %NULL as your get_property() or set_property()
|
|
function. The D-Bus call will be directed to your @method_call function,
|
|
with the provided @interface_name set to "org.freedesktop.DBus.Properties".
|
|
|
|
Ownership of the #GDBusMethodInvocation object passed to the
|
|
method_call() function is transferred to your handler; you must
|
|
call one of the methods of #GDBusMethodInvocation to return a reply
|
|
(possibly empty), or an error. These functions also take ownership
|
|
of the passed-in invocation object, so unless the invocation
|
|
object has otherwise been referenced, it will be then be freed.
|
|
Calling one of these functions may be done within your
|
|
method_call() implementation but it also can be done at a later
|
|
point to handle the method asynchronously.
|
|
|
|
The usual checks on the validity of the calls is performed. For
|
|
`Get` calls, an error is automatically returned if the property does
|
|
not exist or the permissions do not allow access. The same checks are
|
|
performed for `Set` calls, and the provided value is also checked for
|
|
being the correct type.
|
|
|
|
For both `Get` and `Set` calls, the #GDBusMethodInvocation
|
|
passed to the @method_call handler can be queried with
|
|
g_dbus_method_invocation_get_property_info() to get a pointer
|
|
to the #GDBusPropertyInfo of the property.
|
|
|
|
If you have readable properties specified in your interface info,
|
|
you must ensure that you either provide a non-%NULL @get_property()
|
|
function or provide implementations of both the `Get` and `GetAll`
|
|
methods on org.freedesktop.DBus.Properties interface in your @method_call
|
|
function. Note that the required return type of the `Get` call is
|
|
`(v)`, not the type of the property. `GetAll` expects a return value
|
|
of type `a{sv}`.
|
|
|
|
If you have writable properties specified in your interface info,
|
|
you must ensure that you either provide a non-%NULL @set_property()
|
|
function or provide an implementation of the `Set` call. If implementing
|
|
the call, you must return the value of type %G_VARIANT_TYPE_UNIT.</doc>
|
|
<source-position filename="gdbusconnection.h" line="396"/>
|
|
<field name="method_call" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="336">Function for handling incoming method calls.</doc>
|
|
<type name="DBusInterfaceMethodCallFunc" c:type="GDBusInterfaceMethodCallFunc"/>
|
|
</field>
|
|
<field name="get_property" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="337">Function for getting a property.</doc>
|
|
<type name="DBusInterfaceGetPropertyFunc" c:type="GDBusInterfaceGetPropertyFunc"/>
|
|
</field>
|
|
<field name="set_property" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="338">Function for setting a property.</doc>
|
|
<type name="DBusInterfaceSetPropertyFunc" c:type="GDBusInterfaceSetPropertyFunc"/>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<class name="DBusMenuModel" c:symbol-prefix="dbus_menu_model" c:type="GDBusMenuModel" parent="MenuModel" glib:type-name="GDBusMenuModel" glib:get-type="g_dbus_menu_model_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5692">#GDBusMenuModel is an implementation of #GMenuModel that can be used
|
|
as a proxy for a menu model that is exported over D-Bus with
|
|
g_dbus_connection_export_menu_model().</doc>
|
|
<function name="get" c:identifier="g_dbus_menu_model_get" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17071">Obtains a #GDBusMenuModel for the menu model which is exported
|
|
at the given @bus_name and @object_path.
|
|
|
|
The thread default main context is taken at the time of this call.
|
|
All signals on the menu model (and any linked models) are reported
|
|
with respect to this context. All calls on the returned menu model
|
|
(and linked models) must also originate from this same context, with
|
|
the thread default main context unchanged.</doc>
|
|
<source-position filename="gdbusmenumodel.h" line="39"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17087">a #GDBusMenuModel object. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusMenuModel" c:type="GDBusMenuModel*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17073">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="bus_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17074">the bus name which exports the menu model
|
|
or %NULL if @connection is not a message bus connection</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17076">the object path at which the menu model is exported</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</class>
|
|
<class name="DBusMessage" c:symbol-prefix="dbus_message" c:type="GDBusMessage" version="2.26" parent="GObject.Object" glib:type-name="GDBusMessage" glib:get-type="g_dbus_message_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5705">A type for representing D-Bus messages that can be sent or received
|
|
on a #GDBusConnection.</doc>
|
|
<constructor name="new" c:identifier="g_dbus_message_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17359">Creates a new empty #GDBusMessage.</doc>
|
|
<source-position filename="gdbusmessage.h" line="39"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17364">A #GDBusMessage. Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<constructor name="new_from_blob" c:identifier="g_dbus_message_new_from_blob" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17369">Creates a new #GDBusMessage from the data stored at @blob. The byte
|
|
order that the message was in can be retrieved using
|
|
g_dbus_message_get_byte_order().
|
|
|
|
If the @blob cannot be parsed, contains invalid fields, or contains invalid
|
|
headers, %G_IO_ERROR_INVALID_ARGUMENT will be returned.</doc>
|
|
<source-position filename="gdbusmessage.h" line="175"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17383">A new #GDBusMessage or %NULL if @error is set. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="blob" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17371">A blob representing a binary D-Bus message.</doc>
|
|
<array length="1" zero-terminated="0" c:type="guchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="blob_len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17372">The length of @blob.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="capabilities" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17373">A #GDBusCapabilityFlags describing what protocol features are supported.</doc>
|
|
<type name="DBusCapabilityFlags" c:type="GDBusCapabilityFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_method_call" c:identifier="g_dbus_message_new_method_call" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17389">Creates a new #GDBusMessage for a method call.</doc>
|
|
<source-position filename="gdbusmessage.h" line="45"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17398">A #GDBusMessage. Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17391">A valid D-Bus name or %NULL.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17392">A valid object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17393">A valid D-Bus interface name or %NULL.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="method" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17394">A valid method name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_signal" c:identifier="g_dbus_message_new_signal" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17459">Creates a new #GDBusMessage for a signal emission.</doc>
|
|
<source-position filename="gdbusmessage.h" line="41"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17467">A #GDBusMessage. Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17461">A valid object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17462">A valid D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17463">A valid signal name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="bytes_needed" c:identifier="g_dbus_message_bytes_needed" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17093">Utility function to calculate how many bytes are needed to
|
|
completely deserialize the D-Bus message stored at @blob.</doc>
|
|
<source-position filename="gdbusmessage.h" line="181"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17102">Number of bytes needed or -1 if @error is set (e.g. if
|
|
@blob contains invalid data or not enough data is available to
|
|
determine the size).</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="blob" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17095">A blob representing a binary D-Bus message.</doc>
|
|
<array length="1" zero-terminated="0" c:type="guchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="blob_len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17096">The length of @blob (must be at least 16).</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="copy" c:identifier="g_dbus_message_copy" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17109">Copies @message. The copy is a deep copy and the returned
|
|
#GDBusMessage is completely identical except that it is guaranteed
|
|
to not be locked.
|
|
|
|
This operation can fail if e.g. @message contains file descriptors
|
|
and the per-process or system-wide open files limit is reached.</doc>
|
|
<source-position filename="gdbusmessage.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17121">A new #GDBusMessage or %NULL if @error is set.
|
|
Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17111">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_arg0" c:identifier="g_dbus_message_get_arg0" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17127">Convenience to get the first item in the body of @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="171"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17133">The string item or %NULL if the first item in the body of
|
|
@message is not a string.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17129">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_body" c:identifier="g_dbus_message_get_body" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17139">Gets the body of a message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17145">A #GVariant or %NULL if the body is
|
|
empty. Do not free, it is owned by @message.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17141">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_byte_order" c:identifier="g_dbus_message_get_byte_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17151">Gets the byte order of @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17157">The byte order.</doc>
|
|
<type name="DBusMessageByteOrder" c:type="GDBusMessageByteOrder"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17153">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_destination" c:identifier="g_dbus_message_get_destination" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17161">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="147"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17167">The value.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17163">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_error_name" c:identifier="g_dbus_message_get_error_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17172">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17178">The value.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17174">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_dbus_message_get_flags" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17183">Gets the flags for @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17189">Flags that are set (typically values from the #GDBusMessageFlags enumeration bitwise ORed together).</doc>
|
|
<type name="DBusMessageFlags" c:type="GDBusMessageFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17185">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_header" c:identifier="g_dbus_message_get_header" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17194">Gets a header field on @message.
|
|
|
|
The caller is responsible for checking the type of the returned #GVariant
|
|
matches what is expected.</doc>
|
|
<source-position filename="gdbusmessage.h" line="97"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17204">A #GVariant with the value if the header was found, %NULL
|
|
otherwise. Do not free, it is owned by @message.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17196">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="header_field" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17197">A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)</doc>
|
|
<type name="DBusMessageHeaderField" c:type="GDBusMessageHeaderField"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_header_fields" c:identifier="g_dbus_message_get_header_fields" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17210">Gets an array of all header fields on @message that are set.</doc>
|
|
<source-position filename="gdbusmessage.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17216">An array of header fields
|
|
terminated by %G_DBUS_MESSAGE_HEADER_FIELD_INVALID. Each element
|
|
is a #guchar. Free with g_free().</doc>
|
|
<array c:type="guchar*">
|
|
<type name="guint8" c:type="guchar"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17212">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_interface" c:identifier="g_dbus_message_get_interface" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17223">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17229">The value.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17225">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_locked" c:identifier="g_dbus_message_get_locked" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17234">Checks whether @message is locked. To monitor changes to this
|
|
value, conncet to the #GObject::notify signal to listen for changes
|
|
on the #GDBusMessage:locked property.</doc>
|
|
<source-position filename="gdbusmessage.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17242">%TRUE if @message is locked, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17236">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_member" c:identifier="g_dbus_message_get_member" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17247">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17253">The value.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17249">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_message_type" c:identifier="g_dbus_message_get_message_type" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17258">Gets the type of @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17264">A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).</doc>
|
|
<type name="DBusMessageType" c:type="GDBusMessageType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17260">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_num_unix_fds" c:identifier="g_dbus_message_get_num_unix_fds" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17269">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="165"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17275">The value.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17271">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_path" c:identifier="g_dbus_message_get_path" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17280">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="135"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17286">The value.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17282">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_reply_serial" c:identifier="g_dbus_message_get_reply_serial" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17291">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="117"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17297">The value.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17293">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sender" c:identifier="g_dbus_message_get_sender" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17302">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="141"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17308">The value.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17304">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_serial" c:identifier="g_dbus_message_get_serial" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17313">Gets the serial for @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17319">A #guint32.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17315">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_signature" c:identifier="g_dbus_message_get_signature" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17324">Convenience getter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="159"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17330">The value.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17326">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_unix_fd_list" c:identifier="g_dbus_message_get_unix_fd_list" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17335">Gets the UNIX file descriptors associated with @message, if any.
|
|
|
|
This method is only available on UNIX.</doc>
|
|
<source-position filename="gdbusmessage.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17343">A #GUnixFDList or %NULL if no file descriptors are
|
|
associated. Do not free, this object is owned by @message.</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17337">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lock" c:identifier="g_dbus_message_lock" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17349">If @message is locked, does nothing. Otherwise locks the message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17351">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="new_method_error" c:identifier="g_dbus_message_new_method_error" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17403">Creates a new #GDBusMessage that is an error reply to @method_call_message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="52"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17413">A #GDBusMessage. Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="method_call_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17405">A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
|
|
create a reply message to.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17407">A valid D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="error_message_format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17408">The D-Bus error message in a printf() format.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17409">Arguments for @error_message_format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="new_method_error_literal" c:identifier="g_dbus_message_new_method_error_literal" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17418">Creates a new #GDBusMessage that is an error reply to @method_call_message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="62"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17427">A #GDBusMessage. Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="method_call_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17420">A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
|
|
create a reply message to.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17422">A valid D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="error_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17423">The D-Bus error message.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="new_method_error_valist" c:identifier="g_dbus_message_new_method_error_valist" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17432">Like g_dbus_message_new_method_error() but intended for language bindings.</doc>
|
|
<source-position filename="gdbusmessage.h" line="57"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17442">A #GDBusMessage. Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="method_call_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17434">A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
|
|
create a reply message to.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17436">A valid D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="error_message_format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17437">The D-Bus error message in a printf() format.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="var_args" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17438">Arguments for @error_message_format.</doc>
|
|
<type name="va_list" c:type="va_list"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="new_method_reply" c:identifier="g_dbus_message_new_method_reply" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17447">Creates a new #GDBusMessage that is a reply to @method_call_message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17454">#GDBusMessage. Free with g_object_unref().</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="method_call_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17449">A message of type %G_DBUS_MESSAGE_TYPE_METHOD_CALL to
|
|
create a reply message to.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="print" c:identifier="g_dbus_message_print" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17472">Produces a human-readable multi-line description of @message.
|
|
|
|
The contents of the description has no ABI guarantees, the contents
|
|
and formatting is subject to change at any time. Typical output
|
|
looks something like this:
|
|
|[
|
|
Flags: none
|
|
Version: 0
|
|
Serial: 4
|
|
Headers:
|
|
path -> objectpath '/org/gtk/GDBus/TestObject'
|
|
interface -> 'org.gtk.GDBus.TestInterface'
|
|
member -> 'GimmeStdout'
|
|
destination -> ':1.146'
|
|
Body: ()
|
|
UNIX File Descriptors:
|
|
(none)
|
|
]|
|
|
or
|
|
|[
|
|
Flags: no-reply-expected
|
|
Version: 0
|
|
Serial: 477
|
|
Headers:
|
|
reply-serial -> uint32 4
|
|
destination -> ':1.159'
|
|
sender -> ':1.146'
|
|
num-unix-fds -> uint32 1
|
|
Body: ()
|
|
UNIX File Descriptors:
|
|
fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635
|
|
]|</doc>
|
|
<source-position filename="gdbusmessage.h" line="66"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17510">A string that should be freed with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17474">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="indent" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17475">Indentation level.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_body" c:identifier="g_dbus_message_set_body" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17515">Sets the body @message. As a side-effect the
|
|
%G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field is set to the
|
|
type string of @body (or cleared if @body is %NULL).
|
|
|
|
If @body is floating, @message assumes ownership of @body.</doc>
|
|
<source-position filename="gdbusmessage.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17517">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="body" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17518">Either %NULL or a #GVariant that is a tuple.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_byte_order" c:identifier="g_dbus_message_set_byte_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17530">Sets the byte order of @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17532">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="byte_order" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17533">The byte order.</doc>
|
|
<type name="DBusMessageByteOrder" c:type="GDBusMessageByteOrder"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_destination" c:identifier="g_dbus_message_set_destination" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17539">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17541">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17542">The value to set.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_error_name" c:identifier="g_dbus_message_set_error_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17550">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17552">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17553">The value to set.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flags" c:identifier="g_dbus_message_set_flags" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17561">Sets the flags to set on @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17563">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17564">Flags for @message that are set (typically values from the #GDBusMessageFlags
|
|
enumeration bitwise ORed together).</doc>
|
|
<type name="DBusMessageFlags" c:type="GDBusMessageFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_header" c:identifier="g_dbus_message_set_header" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17573">Sets a header field on @message.
|
|
|
|
If @value is floating, @message assumes ownership of @value.</doc>
|
|
<source-position filename="gdbusmessage.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17575">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="header_field" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17576">A 8-bit unsigned integer (typically a value from the #GDBusMessageHeaderField enumeration)</doc>
|
|
<type name="DBusMessageHeaderField" c:type="GDBusMessageHeaderField"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17577">A #GVariant to set the header field or %NULL to clear the header field.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_interface" c:identifier="g_dbus_message_set_interface" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17587">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="125"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17589">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17590">The value to set.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_member" c:identifier="g_dbus_message_set_member" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17598">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_MEMBER header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17600">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17601">The value to set.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_message_type" c:identifier="g_dbus_message_set_message_type" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17609">Sets @message to be of @type.</doc>
|
|
<source-position filename="gdbusmessage.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17611">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17612">A 8-bit unsigned integer (typically a value from the #GDBusMessageType enumeration).</doc>
|
|
<type name="DBusMessageType" c:type="GDBusMessageType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_num_unix_fds" c:identifier="g_dbus_message_set_num_unix_fds" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17620">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="167"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17622">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17623">The value to set.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_path" c:identifier="g_dbus_message_set_path" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17631">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_PATH header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17633">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17634">The value to set.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_reply_serial" c:identifier="g_dbus_message_set_reply_serial" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17642">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17644">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17645">The value to set.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_sender" c:identifier="g_dbus_message_set_sender" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17653">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SENDER header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17655">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17656">The value to set.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_serial" c:identifier="g_dbus_message_set_serial" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17664">Sets the serial for @message.</doc>
|
|
<source-position filename="gdbusmessage.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17666">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="serial" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17667">A #guint32.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_signature" c:identifier="g_dbus_message_set_signature" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17675">Convenience setter for the %G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE header field.</doc>
|
|
<source-position filename="gdbusmessage.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17677">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17678">The value to set.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_unix_fd_list" c:identifier="g_dbus_message_set_unix_fd_list" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17686">Sets the UNIX file descriptors associated with @message. As a
|
|
side-effect the %G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS header
|
|
field is set to the number of fds in @fd_list (or cleared if
|
|
@fd_list is %NULL).
|
|
|
|
This method is only available on UNIX.</doc>
|
|
<source-position filename="gdbusmessage.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17688">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="fd_list" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17689">A #GUnixFDList or %NULL.</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_blob" c:identifier="g_dbus_message_to_blob" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17702">Serializes @message to a blob. The byte order returned by
|
|
g_dbus_message_get_byte_order() will be used.</doc>
|
|
<source-position filename="gdbusmessage.h" line="186"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17712">A pointer to a
|
|
valid binary D-Bus message of @out_size bytes generated by @message
|
|
or %NULL if @error is set. Free with g_free().</doc>
|
|
<array length="0" zero-terminated="0" c:type="guchar*">
|
|
<type name="guint8" c:type="guchar"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17704">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_size" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17705">Return location for size of generated blob.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="capabilities" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17706">A #GDBusCapabilityFlags describing what protocol features are supported.</doc>
|
|
<type name="DBusCapabilityFlags" c:type="GDBusCapabilityFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_gerror" c:identifier="g_dbus_message_to_gerror" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17719">If @message is not of type %G_DBUS_MESSAGE_TYPE_ERROR does
|
|
nothing and returns %FALSE.
|
|
|
|
Otherwise this method encodes the error in @message as a #GError
|
|
using g_dbus_error_set_dbus_error() using the information in the
|
|
%G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME header field of @message as
|
|
well as the first string item in @message's body.</doc>
|
|
<source-position filename="gdbusmessage.h" line="192"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17732">%TRUE if @error was set, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17721">A #GDBusMessage.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="locked" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
</class>
|
|
<enumeration name="DBusMessageByteOrder" version="2.26" glib:type-name="GDBusMessageByteOrder" glib:get-type="g_dbus_message_byte_order_get_type" c:type="GDBusMessageByteOrder">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1446">Enumeration used to describe the byte order of a D-Bus message.</doc>
|
|
<member name="big_endian" value="66" c:identifier="G_DBUS_MESSAGE_BYTE_ORDER_BIG_ENDIAN" glib:nick="big-endian">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1448">The byte order is big endian.</doc>
|
|
</member>
|
|
<member name="little_endian" value="108" c:identifier="G_DBUS_MESSAGE_BYTE_ORDER_LITTLE_ENDIAN" glib:nick="little-endian">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1449">The byte order is little endian.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<callback name="DBusMessageFilterFunction" c:type="GDBusMessageFilterFunction" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="589">Signature for function used in g_dbus_connection_add_filter().
|
|
|
|
A filter function is passed a #GDBusMessage and expected to return
|
|
a #GDBusMessage too. Passive filter functions that don't modify the
|
|
message can simply return the @message object:
|
|
|[
|
|
static GDBusMessage *
|
|
passive_filter (GDBusConnection *connection
|
|
GDBusMessage *message,
|
|
gboolean incoming,
|
|
gpointer user_data)
|
|
{
|
|
// inspect @message
|
|
return message;
|
|
}
|
|
]|
|
|
Filter functions that wants to drop a message can simply return %NULL:
|
|
|[
|
|
static GDBusMessage *
|
|
drop_filter (GDBusConnection *connection
|
|
GDBusMessage *message,
|
|
gboolean incoming,
|
|
gpointer user_data)
|
|
{
|
|
if (should_drop_message)
|
|
{
|
|
g_object_unref (message);
|
|
message = NULL;
|
|
}
|
|
return message;
|
|
}
|
|
]|
|
|
Finally, a filter function may modify a message by copying it:
|
|
|[
|
|
static GDBusMessage *
|
|
modifying_filter (GDBusConnection *connection
|
|
GDBusMessage *message,
|
|
gboolean incoming,
|
|
gpointer user_data)
|
|
{
|
|
GDBusMessage *copy;
|
|
GError *error;
|
|
|
|
error = NULL;
|
|
copy = g_dbus_message_copy (message, &error);
|
|
// handle @error being set
|
|
g_object_unref (message);
|
|
|
|
// modify @copy
|
|
|
|
return copy;
|
|
}
|
|
]|
|
|
If the returned #GDBusMessage is different from @message and cannot
|
|
be sent on @connection (it could use features, such as file
|
|
descriptors, not compatible with @connection), then a warning is
|
|
logged to standard error. Applications can
|
|
check this ahead of time using g_dbus_message_to_blob() passing a
|
|
#GDBusCapabilityFlags value obtained from @connection.</doc>
|
|
<source-position filename="gdbusconnection.h" line="663"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="657">A #GDBusMessage that will be freed with
|
|
g_object_unref() or %NULL to drop the message. Passive filter
|
|
functions can simply return the passed @message object.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="591">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="592">A locked #GDBusMessage that the filter function takes ownership of.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</parameter>
|
|
<parameter name="incoming" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="593">%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>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="595">User data passed when adding the filter.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="DBusMessageFlags" version="2.26" glib:type-name="GDBusMessageFlags" glib:get-type="g_dbus_message_flags_get_type" c:type="GDBusMessageFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1276">Message flags used in #GDBusMessage.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_MESSAGE_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1278">No flags set.</doc>
|
|
</member>
|
|
<member name="no_reply_expected" value="1" c:identifier="G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED" glib:nick="no-reply-expected">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1279">A reply is not expected.</doc>
|
|
</member>
|
|
<member name="no_auto_start" value="2" c:identifier="G_DBUS_MESSAGE_FLAGS_NO_AUTO_START" glib:nick="no-auto-start">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1280">The bus must not launch an
|
|
owner for the destination name in response to this message.</doc>
|
|
</member>
|
|
<member name="allow_interactive_authorization" value="4" c:identifier="G_DBUS_MESSAGE_FLAGS_ALLOW_INTERACTIVE_AUTHORIZATION" glib:nick="allow-interactive-authorization">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1282">If set on a method
|
|
call, this flag means that the caller is prepared to wait for interactive
|
|
authorization. Since 2.46.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<enumeration name="DBusMessageHeaderField" version="2.26" glib:type-name="GDBusMessageHeaderField" glib:get-type="g_dbus_message_header_field_get_type" c:type="GDBusMessageHeaderField">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1297">Header fields used in #GDBusMessage.</doc>
|
|
<member name="invalid" value="0" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_INVALID" glib:nick="invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1299">Not a valid header field.</doc>
|
|
</member>
|
|
<member name="path" value="1" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_PATH" glib:nick="path">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1300">The object path.</doc>
|
|
</member>
|
|
<member name="interface" value="2" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_INTERFACE" glib:nick="interface">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1301">The interface name.</doc>
|
|
</member>
|
|
<member name="member" value="3" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_MEMBER" glib:nick="member">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1302">The method or signal name.</doc>
|
|
</member>
|
|
<member name="error_name" value="4" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_ERROR_NAME" glib:nick="error-name">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1303">The name of the error that occurred.</doc>
|
|
</member>
|
|
<member name="reply_serial" value="5" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_REPLY_SERIAL" glib:nick="reply-serial">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1304">The serial number the message is a reply to.</doc>
|
|
</member>
|
|
<member name="destination" value="6" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_DESTINATION" glib:nick="destination">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1305">The name the message is intended for.</doc>
|
|
</member>
|
|
<member name="sender" value="7" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_SENDER" glib:nick="sender">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1306">Unique name of the sender of the message (filled in by the bus).</doc>
|
|
</member>
|
|
<member name="signature" value="8" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_SIGNATURE" glib:nick="signature">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1307">The signature of the message body.</doc>
|
|
</member>
|
|
<member name="num_unix_fds" value="9" c:identifier="G_DBUS_MESSAGE_HEADER_FIELD_NUM_UNIX_FDS" glib:nick="num-unix-fds">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1308">The number of UNIX file descriptors that accompany the message.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<enumeration name="DBusMessageType" version="2.26" glib:type-name="GDBusMessageType" glib:get-type="g_dbus_message_type_get_type" c:type="GDBusMessageType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1256">Message types used in #GDBusMessage.</doc>
|
|
<member name="invalid" value="0" c:identifier="G_DBUS_MESSAGE_TYPE_INVALID" glib:nick="invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1258">Message is of invalid type.</doc>
|
|
</member>
|
|
<member name="method_call" value="1" c:identifier="G_DBUS_MESSAGE_TYPE_METHOD_CALL" glib:nick="method-call">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1259">Method call.</doc>
|
|
</member>
|
|
<member name="method_return" value="2" c:identifier="G_DBUS_MESSAGE_TYPE_METHOD_RETURN" glib:nick="method-return">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1260">Method reply.</doc>
|
|
</member>
|
|
<member name="error" value="3" c:identifier="G_DBUS_MESSAGE_TYPE_ERROR" glib:nick="error">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1261">Error reply.</doc>
|
|
</member>
|
|
<member name="signal" value="4" c:identifier="G_DBUS_MESSAGE_TYPE_SIGNAL" glib:nick="signal">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1262">Signal emission.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="DBusMethodInfo" c:type="GDBusMethodInfo" version="2.26" glib:type-name="GDBusMethodInfo" glib:get-type="g_dbus_method_info_get_type" c:symbol-prefix="dbus_method_info">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="72">Information about a method on an D-Bus interface.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="92"/>
|
|
<field name="ref_count" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="74">The reference count or -1 if statically allocated.</doc>
|
|
<type name="gint" c:type="volatile gint"/>
|
|
</field>
|
|
<field name="name" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="75">The name of the D-Bus method, e.g. @RequestName.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="in_args" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="76">A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no in arguments.</doc>
|
|
<array c:type="GDBusArgInfo**">
|
|
<type name="DBusArgInfo" c:type="GDBusArgInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="out_args" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="77">A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no out arguments.</doc>
|
|
<array c:type="GDBusArgInfo**">
|
|
<type name="DBusArgInfo" c:type="GDBusArgInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="annotations" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="78">A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</field>
|
|
<method name="ref" c:identifier="g_dbus_method_info_ref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17737">If @info is statically allocated does nothing. Otherwise increases
|
|
the reference count.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="220"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17744">The same @info.</doc>
|
|
<type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17739">A #GDBusMethodInfo</doc>
|
|
<type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_dbus_method_info_unref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17749">If @info is statically allocated, does nothing. Otherwise decreases
|
|
the reference count of @info. When its reference count drops to 0,
|
|
the memory used is freed.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="235"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17751">A #GDBusMethodInfo.</doc>
|
|
<type name="DBusMethodInfo" c:type="GDBusMethodInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<class name="DBusMethodInvocation" c:symbol-prefix="dbus_method_invocation" c:type="GDBusMethodInvocation" version="2.26" parent="GObject.Object" glib:type-name="GDBusMethodInvocation" glib:get-type="g_dbus_method_invocation_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5715">Instances of the #GDBusMethodInvocation class are used when
|
|
handling D-Bus method calls. It provides a way to asynchronously
|
|
return results and errors.
|
|
|
|
The normal way to obtain a #GDBusMethodInvocation object is to receive
|
|
it as an argument to the handle_method_call() function in a
|
|
#GDBusInterfaceVTable that was passed to g_dbus_connection_register_object().</doc>
|
|
<method name="get_connection" c:identifier="g_dbus_method_invocation_get_connection" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17761">Gets the #GDBusConnection the method was invoked on.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17767">A #GDBusConnection. Do not free, it is owned by @invocation.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17763">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_interface_name" c:identifier="g_dbus_method_invocation_get_interface_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17772">Gets the name of the D-Bus interface the method was invoked on.
|
|
|
|
If this method call is a property Get, Set or GetAll call that has
|
|
been redirected to the method call handler then
|
|
"org.freedesktop.DBus.Properties" will be returned. See
|
|
#GDBusInterfaceVTable for more information.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="43"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17783">A string. Do not free, it is owned by @invocation.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17774">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_message" c:identifier="g_dbus_method_invocation_get_message" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17788">Gets the #GDBusMessage for the method invocation. This is useful if
|
|
you need to use low-level protocol features, such as UNIX file
|
|
descriptor passing, that cannot be properly expressed in the
|
|
#GVariant API.
|
|
|
|
See this [server][gdbus-server] and [client][gdbus-unix-fd-client]
|
|
for an example of how to use this low-level API to send and receive
|
|
UNIX file descriptors.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17801">#GDBusMessage. Do not free, it is owned by @invocation.</doc>
|
|
<type name="DBusMessage" c:type="GDBusMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17790">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_method_info" c:identifier="g_dbus_method_invocation_get_method_info" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17806">Gets information about the method call, if any.
|
|
|
|
If this method invocation is a property Get, Set or GetAll call that
|
|
has been redirected to the method call handler then %NULL will be
|
|
returned. See g_dbus_method_invocation_get_property_info() and
|
|
#GDBusInterfaceVTable for more information.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17817">A #GDBusMethodInfo or %NULL. Do not free, it is owned by @invocation.</doc>
|
|
<type name="DBusMethodInfo" c:type="const GDBusMethodInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17808">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_method_name" c:identifier="g_dbus_method_invocation_get_method_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17822">Gets the name of the method that was invoked.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="45"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17828">A string. Do not free, it is owned by @invocation.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17824">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object_path" c:identifier="g_dbus_method_invocation_get_object_path" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17833">Gets the object path the method was invoked on.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="41"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17839">A string. Do not free, it is owned by @invocation.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17835">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_parameters" c:identifier="g_dbus_method_invocation_get_parameters" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17844">Gets the parameters of the method invocation. If there are no input
|
|
parameters then this will return a GVariant with 0 children rather than NULL.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17851">A #GVariant tuple. Do not unref this because it is owned by @invocation.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17846">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_property_info" c:identifier="g_dbus_method_invocation_get_property_info" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17856">Gets information about the property that this method call is for, if
|
|
any.
|
|
|
|
This will only be set in the case of an invocation in response to a
|
|
property Get or Set call that has been directed to the method call
|
|
handler for an object on account of its property_get() or
|
|
property_set() vtable pointers being unset.
|
|
|
|
See #GDBusInterfaceVTable for more information.
|
|
|
|
If the call was GetAll, %NULL will be returned.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="49"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17872">a #GDBusPropertyInfo or %NULL</doc>
|
|
<type name="DBusPropertyInfo" c:type="const GDBusPropertyInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17858">A #GDBusMethodInvocation</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sender" c:identifier="g_dbus_method_invocation_get_sender" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17877">Gets the bus name that invoked the method.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="39"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17883">A string. Do not free, it is owned by @invocation.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17879">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_user_data" c:identifier="g_dbus_method_invocation_get_user_data" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17888">Gets the @user_data #gpointer passed to g_dbus_connection_register_object().</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="57"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17894">A #gpointer.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17890">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_dbus_error" c:identifier="g_dbus_method_invocation_return_dbus_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17899">Finishes handling a D-Bus method call by returning an error.
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17901">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17902">A valid D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="error_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17903">A valid D-Bus error message.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_error" c:identifier="g_dbus_method_invocation_return_error" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17915">Finishes handling a D-Bus method call by returning an error.
|
|
|
|
See g_dbus_error_encode_gerror() for details about what error name
|
|
will be returned on the wire. In a nutshell, if the given error is
|
|
registered using g_dbus_error_register_error() the name given
|
|
during registration is used. Otherwise, a name of the form
|
|
`org.gtk.GDBus.UnmappedGError.Quark...` is used. This provides
|
|
transparent mapping of #GError between applications using GDBus.
|
|
|
|
If you are writing an application intended to be portable,
|
|
always register errors with g_dbus_error_register_error()
|
|
or use g_dbus_method_invocation_return_dbus_error().
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.
|
|
|
|
Since 2.48, if the method call requested for a reply not to be sent
|
|
then this call will free @invocation but otherwise do nothing (as per
|
|
the recommendations of the D-Bus specification).</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17917">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17918">A #GQuark for the #GError error domain.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17919">The error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17920">printf()-style format.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17921">Parameters for @format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_error_literal" c:identifier="g_dbus_method_invocation_return_error_literal" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17948">Like g_dbus_method_invocation_return_error() but without printf()-style formatting.
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17950">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17951">A #GQuark for the #GError error domain.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17952">The error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17953">The error message.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_error_valist" c:identifier="g_dbus_method_invocation_return_error_valist" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17965">Like g_dbus_method_invocation_return_error() but intended for
|
|
language bindings.
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17967">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17968">A #GQuark for the #GError error domain.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17969">The error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17970">printf()-style format.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="var_args" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17971">#va_list of parameters for @format.</doc>
|
|
<type name="va_list" c:type="va_list"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_gerror" c:identifier="g_dbus_method_invocation_return_gerror" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17984">Like g_dbus_method_invocation_return_error() but takes a #GError
|
|
instead of the error domain, error code and message.
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17986">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17987">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_value" c:identifier="g_dbus_method_invocation_return_value" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18000">Finishes handling a D-Bus method call by returning @parameters.
|
|
If the @parameters GVariant is floating, it is consumed.
|
|
|
|
It is an error if @parameters is not of the right format: it must be a tuple
|
|
containing the out-parameters of the D-Bus method. Even if the method has a
|
|
single out-parameter, it must be contained in a tuple. If the method has no
|
|
out-parameters, @parameters may be %NULL or an empty tuple.
|
|
|
|
|[<!-- language="C" -->
|
|
GDBusMethodInvocation *invocation = some_invocation;
|
|
g_autofree gchar *result_string = NULL;
|
|
g_autoptr (GError) error = NULL;
|
|
|
|
result_string = calculate_result (&error);
|
|
|
|
if (error != NULL)
|
|
g_dbus_method_invocation_return_gerror (invocation, error);
|
|
else
|
|
g_dbus_method_invocation_return_value (invocation,
|
|
g_variant_new ("(s)", result_string));
|
|
|
|
// Do not free @invocation here; returning a value does that
|
|
]|
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.
|
|
|
|
Since 2.48, if the method call requested for a reply not to be sent
|
|
then this call will sink @parameters and free @invocation, but
|
|
otherwise do nothing (as per the recommendations of the D-Bus
|
|
specification).</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18002">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18003">A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_value_with_unix_fd_list" c:identifier="g_dbus_method_invocation_return_value_with_unix_fd_list" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18042">Like g_dbus_method_invocation_return_value() but also takes a #GUnixFDList.
|
|
|
|
This method is only available on UNIX.
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18044">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18045">A #GVariant tuple with out parameters for the method or %NULL if not passing any parameters.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="fd_list" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18046">A #GUnixFDList or %NULL.</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_error" c:identifier="g_dbus_method_invocation_take_error" version="2.30" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18060">Like g_dbus_method_invocation_return_gerror() but takes ownership
|
|
of @error so the caller does not need to free it.
|
|
|
|
This method will take ownership of @invocation. See
|
|
#GDBusInterfaceVTable for more information about the ownership of
|
|
@invocation.</doc>
|
|
<source-position filename="gdbusmethodinvocation.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="invocation" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18062">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</instance-parameter>
|
|
<parameter name="error" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18063">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<record name="DBusNodeInfo" c:type="GDBusNodeInfo" version="2.26" glib:type-name="GDBusNodeInfo" glib:get-type="g_dbus_node_info_get_type" c:symbol-prefix="dbus_node_info">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="160">Information about nodes in a remote object hierarchy.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="180"/>
|
|
<field name="ref_count" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="162">The reference count or -1 if statically allocated.</doc>
|
|
<type name="gint" c:type="volatile gint"/>
|
|
</field>
|
|
<field name="path" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="163">The path of the node or %NULL if omitted. Note that this may be a relative path. See the D-Bus specification for more details.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="interfaces" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="164">A pointer to a %NULL-terminated array of pointers to #GDBusInterfaceInfo structures or %NULL if there are no interfaces.</doc>
|
|
<array c:type="GDBusInterfaceInfo**">
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="nodes" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="165">A pointer to a %NULL-terminated array of pointers to #GDBusNodeInfo structures or %NULL if there are no nodes.</doc>
|
|
<array c:type="GDBusNodeInfo**">
|
|
<type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="annotations" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="166">A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</field>
|
|
<constructor name="new_for_xml" c:identifier="g_dbus_node_info_new_for_xml" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18105">Parses @xml_data and returns a #GDBusNodeInfo representing the data.
|
|
|
|
The introspection XML must contain exactly one top-level
|
|
<node> element.
|
|
|
|
Note that this routine is using a
|
|
[GMarkup][glib-Simple-XML-Subset-Parser.description]-based
|
|
parser that only accepts a subset of valid XML documents.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="205"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18119">A #GDBusNodeInfo structure or %NULL if @error is set. Free
|
|
with g_dbus_node_info_unref().</doc>
|
|
<type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="xml_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18107">Valid D-Bus introspection XML.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="generate_xml" c:identifier="g_dbus_node_info_generate_xml" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18076">Appends an XML representation of @info (and its children) to @string_builder.
|
|
|
|
This function is typically used for generating introspection XML documents at run-time for
|
|
handling the `org.freedesktop.DBus.Introspectable.Introspect` method.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="211"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18078">A #GDBusNodeInfo.</doc>
|
|
<type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="indent" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18079">Indentation level.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="string_builder" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18080">A #GString to to append XML data to.</doc>
|
|
<type name="GLib.String" c:type="GString*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_interface" c:identifier="g_dbus_node_info_lookup_interface" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18091">Looks up information about an interface.
|
|
|
|
The cost of this function is O(n) in number of interfaces.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="208"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18100">A #GDBusInterfaceInfo or %NULL if not found. Do not free, it is owned by @info.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18093">A #GDBusNodeInfo.</doc>
|
|
<type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18094">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_dbus_node_info_ref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18125">If @info is statically allocated does nothing. Otherwise increases
|
|
the reference count.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="216"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18132">The same @info.</doc>
|
|
<type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18127">A #GDBusNodeInfo</doc>
|
|
<type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_dbus_node_info_unref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18137">If @info is statically allocated, does nothing. Otherwise decreases
|
|
the reference count of @info. When its reference count drops to 0,
|
|
the memory used is freed.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="231"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18139">A #GDBusNodeInfo.</doc>
|
|
<type name="DBusNodeInfo" c:type="GDBusNodeInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<interface name="DBusObject" c:symbol-prefix="dbus_object" c:type="GDBusObject" glib:type-name="GDBusObject" glib:get-type="g_dbus_object_get_type" glib:type-struct="DBusObjectIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5756">The #GDBusObject type is the base type for D-Bus objects on both
|
|
the service side (see #GDBusObjectSkeleton) and the client side
|
|
(see #GDBusObjectProxy). It is essentially just a container of
|
|
interfaces.</doc>
|
|
<source-position filename="gdbusobject.h" line="64"/>
|
|
<virtual-method name="get_interface" invoker="get_interface" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18149">Gets the D-Bus interface with name @interface_name associated with
|
|
@object, if any.</doc>
|
|
<source-position filename="gdbusobject.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18157">%NULL if not found, otherwise a
|
|
#GDBusInterface that must be freed with g_object_unref().</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18151">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18152">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_interfaces" invoker="get_interfaces" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18163">Gets the D-Bus interfaces associated with @object.</doc>
|
|
<source-position filename="gdbusobject.h" line="54"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18169">A list of #GDBusInterface instances.
|
|
The returned list must be freed by g_list_free() after each element has been freed
|
|
with g_object_unref().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DBusInterface"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18165">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_object_path" invoker="get_object_path" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18176">Gets the object path for @object.</doc>
|
|
<source-position filename="gdbusobject.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18182">A string owned by @object. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18178">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="interface_added">
|
|
<source-position filename="gdbusobject.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="interface_removed">
|
|
<source-position filename="gdbusobject.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_interface" c:identifier="g_dbus_object_get_interface" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18149">Gets the D-Bus interface with name @interface_name associated with
|
|
@object, if any.</doc>
|
|
<source-position filename="gdbusobject.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18157">%NULL if not found, otherwise a
|
|
#GDBusInterface that must be freed with g_object_unref().</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18151">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18152">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_interfaces" c:identifier="g_dbus_object_get_interfaces" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18163">Gets the D-Bus interfaces associated with @object.</doc>
|
|
<source-position filename="gdbusobject.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18169">A list of #GDBusInterface instances.
|
|
The returned list must be freed by g_list_free() after each element has been freed
|
|
with g_object_unref().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DBusInterface"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18165">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object_path" c:identifier="g_dbus_object_get_object_path" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18176">Gets the object path for @object.</doc>
|
|
<source-position filename="gdbusobject.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18182">A string owned by @object. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18178">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="interface-added" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="905">Emitted when @interface is added to @object.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="908">The #GDBusInterface that was added.</doc>
|
|
<type name="DBusInterface"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="interface-removed" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="916">Emitted when @interface is removed from @object.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="919">The #GDBusInterface that was removed.</doc>
|
|
<type name="DBusInterface"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="DBusObjectIface" c:type="GDBusObjectIface" glib:is-gtype-struct-for="DBusObject" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusobject.h" line="35">Base object type for D-Bus objects.</doc>
|
|
<source-position filename="gdbusobject.h" line="64"/>
|
|
<field name="parent_iface">
|
|
<doc xml:space="preserve" filename="gdbusobject.h" line="37">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_object_path">
|
|
<callback name="get_object_path">
|
|
<source-position filename="gdbusobject.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18182">A string owned by @object. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18178">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_interfaces">
|
|
<callback name="get_interfaces">
|
|
<source-position filename="gdbusobject.h" line="54"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18169">A list of #GDBusInterface instances.
|
|
The returned list must be freed by g_list_free() after each element has been freed
|
|
with g_object_unref().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DBusInterface"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18165">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_interface">
|
|
<callback name="get_interface">
|
|
<source-position filename="gdbusobject.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18157">%NULL if not found, otherwise a
|
|
#GDBusInterface that must be freed with g_object_unref().</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18151">A #GDBusObject.</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18152">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="interface_added">
|
|
<callback name="interface_added">
|
|
<source-position filename="gdbusobject.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="interface_removed">
|
|
<callback name="interface_removed">
|
|
<source-position filename="gdbusobject.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<interface name="DBusObjectManager" c:symbol-prefix="dbus_object_manager" c:type="GDBusObjectManager" glib:type-name="GDBusObjectManager" glib:get-type="g_dbus_object_manager_get_type" glib:type-struct="DBusObjectManagerIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5768">The #GDBusObjectManager type is the base type for service- and
|
|
client-side implementations of the standardized
|
|
[org.freedesktop.DBus.ObjectManager](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager)
|
|
interface.
|
|
|
|
See #GDBusObjectManagerClient for the client-side implementation
|
|
and #GDBusObjectManagerServer for the service-side implementation.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="76"/>
|
|
<virtual-method name="get_interface" invoker="get_interface" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18371">Gets the interface proxy for @interface_name at @object_path, if
|
|
any.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18380">A #GDBusInterface instance or %NULL. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18373">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18374">Object path to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18375">D-Bus interface name to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_object" invoker="get_object" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18386">Gets the #GDBusObjectProxy at @object_path, if any.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="58"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18393">A #GDBusObject or %NULL. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18388">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18389">Object path to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_object_path" invoker="get_object_path" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18399">Gets the object path that @manager is for.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18405">A string owned by @manager. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18401">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_objects" invoker="get_objects" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18410">Gets all #GDBusObject objects known to @manager.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="57"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18416">A list of
|
|
#GDBusObject objects. The returned list should be freed with
|
|
g_list_free() after each element has been freed with
|
|
g_object_unref().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DBusObject"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18412">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="interface_added">
|
|
<source-position filename="gdbusobjectmanager.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="interface_removed">
|
|
<source-position filename="gdbusobjectmanager.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="object_added">
|
|
<source-position filename="gdbusobjectmanager.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="object_removed">
|
|
<source-position filename="gdbusobjectmanager.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_interface" c:identifier="g_dbus_object_manager_get_interface" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18371">Gets the interface proxy for @interface_name at @object_path, if
|
|
any.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="88"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18380">A #GDBusInterface instance or %NULL. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18373">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18374">Object path to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18375">D-Bus interface name to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object" c:identifier="g_dbus_object_manager_get_object" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18386">Gets the #GDBusObjectProxy at @object_path, if any.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="85"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18393">A #GDBusObject or %NULL. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18388">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18389">Object path to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object_path" c:identifier="g_dbus_object_manager_get_object_path" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18399">Gets the object path that @manager is for.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18405">A string owned by @manager. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18401">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_objects" c:identifier="g_dbus_object_manager_get_objects" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18410">Gets all #GDBusObject objects known to @manager.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18416">A list of
|
|
#GDBusObject objects. The returned list should be freed with
|
|
g_list_free() after each element has been freed with
|
|
g_object_unref().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DBusObject"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18412">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="interface-added" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="935">Emitted when @interface is added to @object.
|
|
|
|
This signal exists purely as a convenience to avoid having to
|
|
connect signals to all objects managed by @manager.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="938">The #GDBusObject on which an interface was added.</doc>
|
|
<type name="DBusObject"/>
|
|
</parameter>
|
|
<parameter name="interface" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="939">The #GDBusInterface that was added.</doc>
|
|
<type name="DBusInterface"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="interface-removed" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="950">Emitted when @interface has been removed from @object.
|
|
|
|
This signal exists purely as a convenience to avoid having to
|
|
connect signals to all objects managed by @manager.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="953">The #GDBusObject on which an interface was removed.</doc>
|
|
<type name="DBusObject"/>
|
|
</parameter>
|
|
<parameter name="interface" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="954">The #GDBusInterface that was removed.</doc>
|
|
<type name="DBusInterface"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="object-added" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="965">Emitted when @object is added to @manager.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="968">The #GDBusObject that was added.</doc>
|
|
<type name="DBusObject"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="object-removed" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="976">Emitted when @object is removed from @manager.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="979">The #GDBusObject that was removed.</doc>
|
|
<type name="DBusObject"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</interface>
|
|
<class name="DBusObjectManagerClient" c:symbol-prefix="dbus_object_manager_client" c:type="GDBusObjectManagerClient" version="2.30" parent="GObject.Object" glib:type-name="GDBusObjectManagerClient" glib:get-type="g_dbus_object_manager_client_get_type" glib:type-struct="DBusObjectManagerClientClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5783">#GDBusObjectManagerClient is used to create, monitor and delete object
|
|
proxies for remote objects exported by a #GDBusObjectManagerServer (or any
|
|
code implementing the
|
|
[org.freedesktop.DBus.ObjectManager](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager)
|
|
interface).
|
|
|
|
Once an instance of this type has been created, you can connect to
|
|
the #GDBusObjectManager::object-added and
|
|
#GDBusObjectManager::object-removed signals and inspect the
|
|
#GDBusObjectProxy objects returned by
|
|
g_dbus_object_manager_get_objects().
|
|
|
|
If the name for a #GDBusObjectManagerClient is not owned by anyone at
|
|
object construction time, the default behavior is to request the
|
|
message bus to launch an owner for the name. This behavior can be
|
|
disabled using the %G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_DO_NOT_AUTO_START
|
|
flag. It's also worth noting that this only works if the name of
|
|
interest is activatable in the first place. E.g. in some cases it
|
|
is not possible to launch an owner for the requested name. In this
|
|
case, #GDBusObjectManagerClient object construction still succeeds but
|
|
there will be no object proxies
|
|
(e.g. g_dbus_object_manager_get_objects() returns the empty list) and
|
|
the #GDBusObjectManagerClient:name-owner property is %NULL.
|
|
|
|
The owner of the requested name can come and go (for example
|
|
consider a system service being restarted) – #GDBusObjectManagerClient
|
|
handles this case too; simply connect to the #GObject::notify
|
|
signal to watch for changes on the #GDBusObjectManagerClient:name-owner
|
|
property. When the name owner vanishes, the behavior is that
|
|
#GDBusObjectManagerClient:name-owner is set to %NULL (this includes
|
|
emission of the #GObject::notify signal) and then
|
|
#GDBusObjectManager::object-removed signals are synthesized
|
|
for all currently existing object proxies. Since
|
|
#GDBusObjectManagerClient:name-owner is %NULL when this happens, you can
|
|
use this information to disambiguate a synthesized signal from a
|
|
genuine signal caused by object removal on the remote
|
|
#GDBusObjectManager. Similarly, when a new name owner appears,
|
|
#GDBusObjectManager::object-added signals are synthesized
|
|
while #GDBusObjectManagerClient:name-owner is still %NULL. Only when all
|
|
object proxies have been added, the #GDBusObjectManagerClient:name-owner
|
|
is set to the new name owner (this includes emission of the
|
|
#GObject::notify signal). Furthermore, you are guaranteed that
|
|
#GDBusObjectManagerClient:name-owner will alternate between a name owner
|
|
(e.g. `:1.42`) and %NULL even in the case where
|
|
the name of interest is atomically replaced
|
|
|
|
Ultimately, #GDBusObjectManagerClient is used to obtain #GDBusProxy
|
|
instances. All signals (including the
|
|
org.freedesktop.DBus.Properties::PropertiesChanged signal)
|
|
delivered to #GDBusProxy instances are guaranteed to originate
|
|
from the name owner. This guarantee along with the behavior
|
|
described above, means that certain race conditions including the
|
|
"half the proxy is from the old owner and the other half is from
|
|
the new owner" problem cannot happen.
|
|
|
|
To avoid having the application connect to signals on the returned
|
|
#GDBusObjectProxy and #GDBusProxy objects, the
|
|
#GDBusObject::interface-added,
|
|
#GDBusObject::interface-removed,
|
|
#GDBusProxy::g-properties-changed and
|
|
#GDBusProxy::g-signal signals
|
|
are also emitted on the #GDBusObjectManagerClient instance managing these
|
|
objects. The signals emitted are
|
|
#GDBusObjectManager::interface-added,
|
|
#GDBusObjectManager::interface-removed,
|
|
#GDBusObjectManagerClient::interface-proxy-properties-changed and
|
|
#GDBusObjectManagerClient::interface-proxy-signal.
|
|
|
|
Note that all callbacks and signals are emitted in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
that the #GDBusObjectManagerClient object was constructed
|
|
in. Additionally, the #GDBusObjectProxy and #GDBusProxy objects
|
|
originating from the #GDBusObjectManagerClient object will be created in
|
|
the same context and, consequently, will deliver signals in the
|
|
same main loop.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="83"/>
|
|
<implements name="AsyncInitable"/>
|
|
<implements name="DBusObjectManager"/>
|
|
<implements name="Initable"/>
|
|
<constructor name="new_finish" c:identifier="g_dbus_object_manager_client_new_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18265">Finishes an operation started with g_dbus_object_manager_client_new().</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18272">A
|
|
#GDBusObjectManagerClient object or %NULL if @error is set. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManager*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18267">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_object_manager_client_new().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_for_bus_finish" c:identifier="g_dbus_object_manager_client_new_for_bus_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18306">Finishes an operation started with g_dbus_object_manager_client_new_for_bus().</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="123"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18313">A
|
|
#GDBusObjectManagerClient object or %NULL if @error is set. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManager*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18308">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_object_manager_client_new_for_bus().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_for_bus_sync" c:identifier="g_dbus_object_manager_client_new_for_bus_sync" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18320">Like g_dbus_object_manager_client_new_sync() but takes a #GBusType instead
|
|
of a #GDBusConnection.
|
|
|
|
This is a synchronous failable constructor - the calling thread is
|
|
blocked until a reply is received. See g_dbus_object_manager_client_new_for_bus()
|
|
for the asynchronous version.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="126"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18339">A
|
|
#GDBusObjectManagerClient object or %NULL if @error is set. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManager*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18322">A #GBusType.</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18323">Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.</doc>
|
|
<type name="DBusObjectManagerClientFlags" c:type="GDBusObjectManagerClientFlags"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18324">The owner of the control object (unique or well-known name).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18325">The object path of the control object.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_func" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18326">A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.</doc>
|
|
<type name="DBusProxyTypeFunc" c:type="GDBusProxyTypeFunc"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18327">User data to pass to @get_proxy_type_func.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_destroy_notify" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18328">Free function for @get_proxy_type_user_data or %NULL.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18329">A #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_sync" c:identifier="g_dbus_object_manager_client_new_sync" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18346">Creates a new #GDBusObjectManagerClient object.
|
|
|
|
This is a synchronous failable constructor - the calling thread is
|
|
blocked until a reply is received. See g_dbus_object_manager_client_new()
|
|
for the asynchronous version.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="102"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18364">A
|
|
#GDBusObjectManagerClient object or %NULL if @error is set. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManager*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18348">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18349">Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.</doc>
|
|
<type name="DBusObjectManagerClientFlags" c:type="GDBusObjectManagerClientFlags"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18350">The owner of the control object (unique or well-known name), or %NULL when not using a message bus connection.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18351">The object path of the control object.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_func" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18352">A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.</doc>
|
|
<type name="DBusProxyTypeFunc" c:type="GDBusProxyTypeFunc"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18353">User data to pass to @get_proxy_type_func.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_destroy_notify" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18354">Free function for @get_proxy_type_user_data or %NULL.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18355">A #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="new" c:identifier="g_dbus_object_manager_client_new" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18239">Asynchronously creates a new #GDBusObjectManagerClient object.
|
|
|
|
This is an asynchronous failable constructor. When the result is
|
|
ready, @callback will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from. You can
|
|
then call g_dbus_object_manager_client_new_finish() to get the result. See
|
|
g_dbus_object_manager_client_new_sync() for the synchronous version.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18241">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18242">Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.</doc>
|
|
<type name="DBusObjectManagerClientFlags" c:type="GDBusObjectManagerClientFlags"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18243">The owner of the control object (unique or well-known name).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18244">The object path of the control object.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_func" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18245">A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.</doc>
|
|
<type name="DBusProxyTypeFunc" c:type="GDBusProxyTypeFunc"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18246">User data to pass to @get_proxy_type_func.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_destroy_notify" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18247">Free function for @get_proxy_type_user_data or %NULL.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18248">A #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="9">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18249">A #GAsyncReadyCallback to call when the request is satisfied.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18250">The data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_bus" c:identifier="g_dbus_object_manager_client_new_for_bus" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18279">Like g_dbus_object_manager_client_new() but takes a #GBusType instead of a
|
|
#GDBusConnection.
|
|
|
|
This is an asynchronous failable constructor. When the result is
|
|
ready, @callback will be invoked in the
|
|
[thread-default main loop][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from. You can
|
|
then call g_dbus_object_manager_client_new_for_bus_finish() to get the result. See
|
|
g_dbus_object_manager_client_new_for_bus_sync() for the synchronous version.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18281">A #GBusType.</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18282">Zero or more flags from the #GDBusObjectManagerClientFlags enumeration.</doc>
|
|
<type name="DBusObjectManagerClientFlags" c:type="GDBusObjectManagerClientFlags"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18283">The owner of the control object (unique or well-known name).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18284">The object path of the control object.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_func" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18285">A #GDBusProxyTypeFunc function or %NULL to always construct #GDBusProxy proxies.</doc>
|
|
<type name="DBusProxyTypeFunc" c:type="GDBusProxyTypeFunc"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18286">User data to pass to @get_proxy_type_func.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="get_proxy_type_destroy_notify" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18287">Free function for @get_proxy_type_user_data or %NULL.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18288">A #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="9">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18289">A #GAsyncReadyCallback to call when the request is satisfied.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18290">The data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="interface_proxy_properties_changed">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_proxy" transfer-ownership="none">
|
|
<type name="DBusObjectProxy" c:type="GDBusObjectProxy*"/>
|
|
</parameter>
|
|
<parameter name="interface_proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</parameter>
|
|
<parameter name="changed_properties" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="invalidated_properties" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar* const*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="interface_proxy_signal">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_proxy" transfer-ownership="none">
|
|
<type name="DBusObjectProxy" c:type="GDBusObjectProxy*"/>
|
|
</parameter>
|
|
<parameter name="interface_proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</parameter>
|
|
<parameter name="sender_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_connection" c:identifier="g_dbus_object_manager_client_get_connection" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18187">Gets the #GDBusConnection used by @manager.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="136"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18193">A #GDBusConnection object. Do not free,
|
|
the object belongs to @manager.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18189">A #GDBusObjectManagerClient</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_dbus_object_manager_client_get_flags" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18199">Gets the flags that @manager was constructed with.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18205">Zero of more flags from the #GDBusObjectManagerClientFlags
|
|
enumeration.</doc>
|
|
<type name="DBusObjectManagerClientFlags" c:type="GDBusObjectManagerClientFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18201">A #GDBusObjectManagerClient</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_dbus_object_manager_client_get_name" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18211">Gets the name that @manager is for, or %NULL if not a message bus
|
|
connection.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="140"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18218">A unique or well-known name. Do not free, the string
|
|
belongs to @manager.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18213">A #GDBusObjectManagerClient</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name_owner" c:identifier="g_dbus_object_manager_client_get_name_owner" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18224">The unique name that owns the name that @manager is for or %NULL if
|
|
no-one currently owns that name. You can connect to the
|
|
#GObject::notify signal to track changes to the
|
|
#GDBusObjectManagerClient:name-owner property.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="142"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18233">The name owner or %NULL if no name owner
|
|
exists. Free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18226">A #GDBusObjectManagerClient.</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="bus-type" version="2.30" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1034">If this property is not %G_BUS_TYPE_NONE, then
|
|
#GDBusObjectManagerClient:connection must be %NULL and will be set to the
|
|
#GDBusConnection obtained by calling g_bus_get() with the value
|
|
of this property.</doc>
|
|
<type name="BusType"/>
|
|
</property>
|
|
<property name="connection" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1046">The #GDBusConnection to use.</doc>
|
|
<type name="DBusConnection"/>
|
|
</property>
|
|
<property name="flags" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1055">Flags from the #GDBusObjectManagerClientFlags enumeration.</doc>
|
|
<type name="DBusObjectManagerClientFlags"/>
|
|
</property>
|
|
<property name="get-proxy-type-destroy-notify" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1064">A #GDestroyNotify for the #gpointer user_data in #GDBusObjectManagerClient:get-proxy-type-user-data.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</property>
|
|
<property name="get-proxy-type-func" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1073">The #GDBusProxyTypeFunc to use when determining what #GType to
|
|
use for interface proxies or %NULL.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</property>
|
|
<property name="get-proxy-type-user-data" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1083">The #gpointer user_data to pass to #GDBusObjectManagerClient:get-proxy-type-func.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</property>
|
|
<property name="name" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1092">The well-known name or unique name that the manager is for.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="name-owner" version="2.30" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1101">The unique name that owns #GDBusObjectManagerClient:name or %NULL if
|
|
no-one is currently owning the name. Connect to the
|
|
#GObject::notify signal to track changes to this property.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="object-path" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1112">The object path the manager is for.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DBusObjectManagerClientPrivate" c:type="GDBusObjectManagerClientPrivate*"/>
|
|
</field>
|
|
<glib:signal name="interface-proxy-properties-changed" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="987">Emitted when one or more D-Bus properties on proxy changes. The
|
|
local cache has already been updated when this signal fires. Note
|
|
that both @changed_properties and @invalidated_properties are
|
|
guaranteed to never be %NULL (either may be empty though).
|
|
|
|
This signal exists purely as a convenience to avoid having to
|
|
connect signals to all interface proxies managed by @manager.
|
|
|
|
This signal is emitted in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
that @manager was constructed in.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="990">The #GDBusObjectProxy on which an interface has properties that are changing.</doc>
|
|
<type name="DBusObjectProxy"/>
|
|
</parameter>
|
|
<parameter name="interface_proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="991">The #GDBusProxy that has properties that are changing.</doc>
|
|
<type name="DBusProxy"/>
|
|
</parameter>
|
|
<parameter name="changed_properties" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="992">A #GVariant containing the properties that changed (type: `a{sv}`).</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
<parameter name="invalidated_properties" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="993">A %NULL terminated
|
|
array of properties that were invalidated.</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="interface-proxy-signal" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1012">Emitted when a D-Bus signal is received on @interface_proxy.
|
|
|
|
This signal exists purely as a convenience to avoid having to
|
|
connect signals to all interface proxies managed by @manager.
|
|
|
|
This signal is emitted in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
that @manager was constructed in.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1015">The #GDBusObjectProxy on which an interface is emitting a D-Bus signal.</doc>
|
|
<type name="DBusObjectProxy"/>
|
|
</parameter>
|
|
<parameter name="interface_proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1016">The #GDBusProxy that is emitting a D-Bus signal.</doc>
|
|
<type name="DBusProxy"/>
|
|
</parameter>
|
|
<parameter name="sender_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1017">The sender of the signal or NULL if the connection is not a bus connection.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1018">The signal name.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1019">A #GVariant tuple with parameters for the signal.</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="DBusObjectManagerClientClass" c:type="GDBusObjectManagerClientClass" glib:is-gtype-struct-for="DBusObjectManagerClient" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusobjectmanagerclient.h" line="53">Class structure for #GDBusObjectManagerClient.</doc>
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="83"/>
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve" filename="gdbusobjectmanagerclient.h" line="55">The parent class.</doc>
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="interface_proxy_signal">
|
|
<callback name="interface_proxy_signal">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</parameter>
|
|
<parameter name="object_proxy" transfer-ownership="none">
|
|
<type name="DBusObjectProxy" c:type="GDBusObjectProxy*"/>
|
|
</parameter>
|
|
<parameter name="interface_proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</parameter>
|
|
<parameter name="sender_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="interface_proxy_properties_changed">
|
|
<callback name="interface_proxy_properties_changed">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</parameter>
|
|
<parameter name="object_proxy" transfer-ownership="none">
|
|
<type name="DBusObjectProxy" c:type="GDBusObjectProxy*"/>
|
|
</parameter>
|
|
<parameter name="interface_proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</parameter>
|
|
<parameter name="changed_properties" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="invalidated_properties" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar* const*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<bitfield name="DBusObjectManagerClientFlags" version="2.30" glib:type-name="GDBusObjectManagerClientFlags" glib:get-type="g_dbus_object_manager_client_flags_get_type" c:type="GDBusObjectManagerClientFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1693">Flags used when constructing a #GDBusObjectManagerClient.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1695">No flags set.</doc>
|
|
</member>
|
|
<member name="do_not_auto_start" value="1" c:identifier="G_DBUS_OBJECT_MANAGER_CLIENT_FLAGS_DO_NOT_AUTO_START" glib:nick="do-not-auto-start">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1696">If not set and the
|
|
manager is for a well-known name, then request the bus to launch
|
|
an owner for the name if no-one owns the name. This flag can only
|
|
be used in managers for well-known names.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="DBusObjectManagerClientPrivate" c:type="GDBusObjectManagerClientPrivate" disguised="1">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="36"/>
|
|
</record>
|
|
<record name="DBusObjectManagerIface" c:type="GDBusObjectManagerIface" glib:is-gtype-struct-for="DBusObjectManager" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusobjectmanager.h" line="35">Base type for D-Bus object managers.</doc>
|
|
<source-position filename="gdbusobjectmanager.h" line="76"/>
|
|
<field name="parent_iface">
|
|
<doc xml:space="preserve" filename="gdbusobjectmanager.h" line="37">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_object_path">
|
|
<callback name="get_object_path">
|
|
<source-position filename="gdbusobjectmanager.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18405">A string owned by @manager. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18401">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_objects">
|
|
<callback name="get_objects">
|
|
<source-position filename="gdbusobjectmanager.h" line="57"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18416">A list of
|
|
#GDBusObject objects. The returned list should be freed with
|
|
g_list_free() after each element has been freed with
|
|
g_object_unref().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DBusObject"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18412">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_object">
|
|
<callback name="get_object">
|
|
<source-position filename="gdbusobjectmanager.h" line="58"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18393">A #GDBusObject or %NULL. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18388">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18389">Object path to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_interface">
|
|
<callback name="get_interface">
|
|
<source-position filename="gdbusobjectmanager.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18380">A #GDBusInterface instance or %NULL. Free
|
|
with g_object_unref().</doc>
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18373">A #GDBusObjectManager.</doc>
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18374">Object path to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18375">D-Bus interface name to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="object_added">
|
|
<callback name="object_added">
|
|
<source-position filename="gdbusobjectmanager.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="object_removed">
|
|
<callback name="object_removed">
|
|
<source-position filename="gdbusobjectmanager.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="interface_added">
|
|
<callback name="interface_added">
|
|
<source-position filename="gdbusobjectmanager.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="interface_removed">
|
|
<callback name="interface_removed">
|
|
<source-position filename="gdbusobjectmanager.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<type name="DBusObjectManager" c:type="GDBusObjectManager*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObject" c:type="GDBusObject*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterface" c:type="GDBusInterface*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="DBusObjectManagerServer" c:symbol-prefix="dbus_object_manager_server" c:type="GDBusObjectManagerServer" version="2.30" parent="GObject.Object" glib:type-name="GDBusObjectManagerServer" glib:get-type="g_dbus_object_manager_server_get_type" glib:type-struct="DBusObjectManagerServerClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5866">#GDBusObjectManagerServer is used to export #GDBusObject instances using
|
|
the standardized
|
|
[org.freedesktop.DBus.ObjectManager](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager)
|
|
interface. For example, remote D-Bus clients can get all objects
|
|
and properties in a single call. Additionally, any change in the
|
|
object hierarchy is broadcast using signals. This means that D-Bus
|
|
clients can keep caches up to date by only listening to D-Bus
|
|
signals.
|
|
|
|
The recommended path to export an object manager at is the path form of the
|
|
well-known name of a D-Bus service, or below. For example, if a D-Bus service
|
|
is available at the well-known name `net.example.ExampleService1`, the object
|
|
manager should typically be exported at `/net/example/ExampleService1`, or
|
|
below (to allow for multiple object managers in a service).
|
|
|
|
It is supported, but not recommended, to export an object manager at the root
|
|
path, `/`.
|
|
|
|
See #GDBusObjectManagerClient for the client-side code that is
|
|
intended to be used with #GDBusObjectManagerServer or any D-Bus
|
|
object implementing the org.freedesktop.DBus.ObjectManager
|
|
interface.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="67"/>
|
|
<implements name="DBusObjectManager"/>
|
|
<constructor name="new" c:identifier="g_dbus_object_manager_server_new" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18483">Creates a new #GDBusObjectManagerServer object.
|
|
|
|
The returned server isn't yet exported on any connection. To do so,
|
|
use g_dbus_object_manager_server_set_connection(). Normally you
|
|
want to export all of your objects before doing so to avoid
|
|
[InterfacesAdded](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager)
|
|
signals being emitted.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="72"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18495">A #GDBusObjectManagerServer object. Free with g_object_unref().</doc>
|
|
<type name="DBusObjectManagerServer" c:type="GDBusObjectManagerServer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18485">The object path to export the manager object at.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="export" c:identifier="g_dbus_object_manager_server_export" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18424">Exports @object on @manager.
|
|
|
|
If there is already a #GDBusObject exported at the object path,
|
|
then the old object is removed.
|
|
|
|
The object path for @object must be in the hierarchy rooted by the
|
|
object path for @manager.
|
|
|
|
Note that @manager will take a reference on @object for as long as
|
|
it is exported.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18426">A #GDBusObjectManagerServer.</doc>
|
|
<type name="DBusObjectManagerServer" c:type="GDBusObjectManagerServer*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18427">A #GDBusObjectSkeleton.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="export_uniquely" c:identifier="g_dbus_object_manager_server_export_uniquely" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18444">Like g_dbus_object_manager_server_export() but appends a string of
|
|
the form _N (with N being a natural number) to @object's object path
|
|
if an object with the given path already exists. As such, the
|
|
#GDBusObjectProxy:g-object-path property of @object may be modified.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18446">A #GDBusObjectManagerServer.</doc>
|
|
<type name="DBusObjectManagerServer" c:type="GDBusObjectManagerServer*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18447">An object.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_connection" c:identifier="g_dbus_object_manager_server_get_connection" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18458">Gets the #GDBusConnection used by @manager.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18464">A #GDBusConnection object or %NULL if
|
|
@manager isn't exported on a connection. The returned object should
|
|
be freed with g_object_unref().</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18460">A #GDBusObjectManagerServer</doc>
|
|
<type name="DBusObjectManagerServer" c:type="GDBusObjectManagerServer*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_exported" c:identifier="g_dbus_object_manager_server_is_exported" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18471">Returns whether @object is currently exported on @manager.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18478">%TRUE if @object is exported</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18473">A #GDBusObjectManagerServer.</doc>
|
|
<type name="DBusObjectManagerServer" c:type="GDBusObjectManagerServer*"/>
|
|
</instance-parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18474">An object.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_connection" c:identifier="g_dbus_object_manager_server_set_connection">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18500">Exports all objects managed by @manager on @connection. If
|
|
@connection is %NULL, stops exporting objects.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18502">A #GDBusObjectManagerServer.</doc>
|
|
<type name="DBusObjectManagerServer" c:type="GDBusObjectManagerServer*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18503">A #GDBusConnection or %NULL.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unexport" c:identifier="g_dbus_object_manager_server_unexport" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18510">If @manager has an object at @path, removes the object. Otherwise
|
|
does nothing.
|
|
|
|
Note that @object_path must be in the hierarchy rooted by the
|
|
object path for @manager.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18521">%TRUE if object at @object_path was removed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18512">A #GDBusObjectManagerServer.</doc>
|
|
<type name="DBusObjectManagerServer" c:type="GDBusObjectManagerServer*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18513">An object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="connection" version="2.30" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1121">The #GDBusConnection to export objects on.</doc>
|
|
<type name="DBusConnection"/>
|
|
</property>
|
|
<property name="object-path" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1130">The object path to register the manager object at.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DBusObjectManagerServerPrivate" c:type="GDBusObjectManagerServerPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="DBusObjectManagerServerClass" c:type="GDBusObjectManagerServerClass" glib:is-gtype-struct-for="DBusObjectManagerServer" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusobjectmanagerserver.h" line="53">Class structure for #GDBusObjectManagerServer.</doc>
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="67"/>
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve" filename="gdbusobjectmanagerserver.h" line="55">The parent class.</doc>
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="DBusObjectManagerServerPrivate" c:type="GDBusObjectManagerServerPrivate" disguised="1">
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="36"/>
|
|
</record>
|
|
<class name="DBusObjectProxy" c:symbol-prefix="dbus_object_proxy" c:type="GDBusObjectProxy" version="2.30" parent="GObject.Object" glib:type-name="GDBusObjectProxy" glib:get-type="g_dbus_object_proxy_get_type" glib:type-struct="DBusObjectProxyClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5896">A #GDBusObjectProxy is an object used to represent a remote object
|
|
with one or more D-Bus interfaces. Normally, you don't instantiate
|
|
a #GDBusObjectProxy yourself - typically #GDBusObjectManagerClient
|
|
is used to obtain it.</doc>
|
|
<source-position filename="gdbusobjectproxy.h" line="67"/>
|
|
<implements name="DBusObject"/>
|
|
<constructor name="new" c:identifier="g_dbus_object_proxy_new" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18538">Creates a new #GDBusObjectProxy for the given connection and
|
|
object path.</doc>
|
|
<source-position filename="gdbusobjectproxy.h" line="72"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18546">a new #GDBusObjectProxy</doc>
|
|
<type name="DBusObjectProxy" c:type="GDBusObjectProxy*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18540">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18541">the object path</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_connection" c:identifier="g_dbus_object_proxy_get_connection" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18526">Gets the connection that @proxy is for.</doc>
|
|
<source-position filename="gdbusobjectproxy.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18532">A #GDBusConnection. Do not free, the
|
|
object is owned by @proxy.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18528">a #GDBusObjectProxy</doc>
|
|
<type name="DBusObjectProxy" c:type="GDBusObjectProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="g-connection" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1139">The connection of the proxy.</doc>
|
|
<type name="DBusConnection"/>
|
|
</property>
|
|
<property name="g-object-path" version="2.30" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1148">The object path of the proxy.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DBusObjectProxyPrivate" c:type="GDBusObjectProxyPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="DBusObjectProxyClass" c:type="GDBusObjectProxyClass" glib:is-gtype-struct-for="DBusObjectProxy" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusobjectproxy.h" line="53">Class structure for #GDBusObjectProxy.</doc>
|
|
<source-position filename="gdbusobjectproxy.h" line="67"/>
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve" filename="gdbusobjectproxy.h" line="55">The parent class.</doc>
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="DBusObjectProxyPrivate" c:type="GDBusObjectProxyPrivate" disguised="1">
|
|
<source-position filename="gdbusobjectproxy.h" line="36"/>
|
|
</record>
|
|
<class name="DBusObjectSkeleton" c:symbol-prefix="dbus_object_skeleton" c:type="GDBusObjectSkeleton" version="2.30" parent="GObject.Object" glib:type-name="GDBusObjectSkeleton" glib:get-type="g_dbus_object_skeleton_get_type" glib:type-struct="DBusObjectSkeletonClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5910">A #GDBusObjectSkeleton instance is essentially a group of D-Bus
|
|
interfaces. The set of exported interfaces on the object may be
|
|
dynamic and change at runtime.
|
|
|
|
This type is intended to be used with #GDBusObjectManager.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="73"/>
|
|
<implements name="DBusObject"/>
|
|
<constructor name="new" c:identifier="g_dbus_object_skeleton_new" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18580">Creates a new #GDBusObjectSkeleton.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18586">A #GDBusObjectSkeleton. Free with g_object_unref().</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18582">An object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<virtual-method name="authorize_method">
|
|
<source-position filename="gdbusobjectskeleton.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
<parameter name="invocation" transfer-ownership="none">
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="add_interface" c:identifier="g_dbus_object_skeleton_add_interface" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18551">Adds @interface_ to @object.
|
|
|
|
If @object already contains a #GDBusInterfaceSkeleton with the same
|
|
interface name, it is removed before @interface_ is added.
|
|
|
|
Note that @object takes its own reference on @interface_ and holds
|
|
it until removed.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18553">A #GDBusObjectSkeleton.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18554">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush" c:identifier="g_dbus_object_skeleton_flush" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18568">This method simply calls g_dbus_interface_skeleton_flush() on all
|
|
interfaces belonging to @object. See that method for when flushing
|
|
is useful.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18570">A #GDBusObjectSkeleton.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_interface" c:identifier="g_dbus_object_skeleton_remove_interface" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18591">Removes @interface_ from @object.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18593">A #GDBusObjectSkeleton.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18594">A #GDBusInterfaceSkeleton.</doc>
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_interface_by_name" c:identifier="g_dbus_object_skeleton_remove_interface_by_name" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18602">Removes the #GDBusInterface with @interface_name from @object.
|
|
|
|
If no D-Bus interface of the given interface exists, this function
|
|
does nothing.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18604">A #GDBusObjectSkeleton.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18605">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_object_path" c:identifier="g_dbus_object_skeleton_set_object_path" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18616">Sets the object path for @object.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18618">A #GDBusObjectSkeleton.</doc>
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</instance-parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18619">A valid D-Bus object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="g-object-path" version="2.30" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1177">The object path where the object is exported.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DBusObjectSkeletonPrivate" c:type="GDBusObjectSkeletonPrivate*"/>
|
|
</field>
|
|
<glib:signal name="authorize-method" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1157">Emitted when a method is invoked by a remote caller and used to
|
|
determine if the method call is authorized.
|
|
|
|
This signal is like #GDBusInterfaceSkeleton's
|
|
#GDBusInterfaceSkeleton::g-authorize-method signal,
|
|
except that it is for the enclosing object.
|
|
|
|
The default class handler just returns %TRUE.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1172">%TRUE if the call is authorized, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1160">The #GDBusInterfaceSkeleton that @invocation is for.</doc>
|
|
<type name="DBusInterfaceSkeleton"/>
|
|
</parameter>
|
|
<parameter name="invocation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1161">A #GDBusMethodInvocation.</doc>
|
|
<type name="DBusMethodInvocation"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="DBusObjectSkeletonClass" c:type="GDBusObjectSkeletonClass" glib:is-gtype-struct-for="DBusObjectSkeleton" version="2.30">
|
|
<doc xml:space="preserve" filename="gdbusobjectskeleton.h" line="53">Class structure for #GDBusObjectSkeleton.</doc>
|
|
<source-position filename="gdbusobjectskeleton.h" line="73"/>
|
|
<field name="parent_class">
|
|
<doc xml:space="preserve" filename="gdbusobjectskeleton.h" line="55">The parent class.</doc>
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="authorize_method">
|
|
<callback name="authorize_method">
|
|
<source-position filename="gdbusobjectskeleton.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<type name="DBusObjectSkeleton" c:type="GDBusObjectSkeleton*"/>
|
|
</parameter>
|
|
<parameter name="interface_" transfer-ownership="none">
|
|
<type name="DBusInterfaceSkeleton" c:type="GDBusInterfaceSkeleton*"/>
|
|
</parameter>
|
|
<parameter name="invocation" transfer-ownership="none">
|
|
<type name="DBusMethodInvocation" c:type="GDBusMethodInvocation*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="DBusObjectSkeletonPrivate" c:type="GDBusObjectSkeletonPrivate" disguised="1">
|
|
<source-position filename="gdbusobjectskeleton.h" line="36"/>
|
|
</record>
|
|
<record name="DBusPropertyInfo" c:type="GDBusPropertyInfo" version="2.26" glib:type-name="GDBusPropertyInfo" glib:get-type="g_dbus_property_info_get_type" c:symbol-prefix="dbus_property_info">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="114">Information about a D-Bus property on a D-Bus interface.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="134"/>
|
|
<field name="ref_count" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="116">The reference count or -1 if statically allocated.</doc>
|
|
<type name="gint" c:type="volatile gint"/>
|
|
</field>
|
|
<field name="name" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="117">The name of the D-Bus property, e.g. "SupportedFilesystems".</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="signature" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="118">The D-Bus signature of the property (a single complete type).</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="flags" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="119">Access control flags for the property.</doc>
|
|
<type name="DBusPropertyInfoFlags" c:type="GDBusPropertyInfoFlags"/>
|
|
</field>
|
|
<field name="annotations" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="120">A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</field>
|
|
<method name="ref" c:identifier="g_dbus_property_info_ref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18627">If @info is statically allocated does nothing. Otherwise increases
|
|
the reference count.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="224"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18634">The same @info.</doc>
|
|
<type name="DBusPropertyInfo" c:type="GDBusPropertyInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18629">A #GDBusPropertyInfo</doc>
|
|
<type name="DBusPropertyInfo" c:type="GDBusPropertyInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_dbus_property_info_unref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18639">If @info is statically allocated, does nothing. Otherwise decreases
|
|
the reference count of @info. When its reference count drops to 0,
|
|
the memory used is freed.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="239"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18641">A #GDBusPropertyInfo.</doc>
|
|
<type name="DBusPropertyInfo" c:type="GDBusPropertyInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<bitfield name="DBusPropertyInfoFlags" version="2.26" glib:type-name="GDBusPropertyInfoFlags" glib:get-type="g_dbus_property_info_flags_get_type" c:type="GDBusPropertyInfoFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1327">Flags describing the access control of a D-Bus property.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_PROPERTY_INFO_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1329">No flags set.</doc>
|
|
</member>
|
|
<member name="readable" value="1" c:identifier="G_DBUS_PROPERTY_INFO_FLAGS_READABLE" glib:nick="readable">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1330">Property is readable.</doc>
|
|
</member>
|
|
<member name="writable" value="2" c:identifier="G_DBUS_PROPERTY_INFO_FLAGS_WRITABLE" glib:nick="writable">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1331">Property is writable.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<class name="DBusProxy" c:symbol-prefix="dbus_proxy" c:type="GDBusProxy" version="2.26" parent="GObject.Object" glib:type-name="GDBusProxy" glib:get-type="g_dbus_proxy_get_type" glib:type-struct="DBusProxyClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5923">#GDBusProxy is a base class used for proxies to access a D-Bus
|
|
interface on a remote object. A #GDBusProxy can be constructed for
|
|
both well-known and unique names.
|
|
|
|
By default, #GDBusProxy will cache all properties (and listen to
|
|
changes) of the remote object, and proxy all signals that get
|
|
emitted. This behaviour can be changed by passing suitable
|
|
#GDBusProxyFlags when the proxy is created. If the proxy is for a
|
|
well-known name, the property cache is flushed when the name owner
|
|
vanishes and reloaded when a name owner appears.
|
|
|
|
The unique name owner of the proxy's name is tracked and can be read from
|
|
#GDBusProxy:g-name-owner. Connect to the #GObject::notify signal to
|
|
get notified of changes. Additionally, only signals and property
|
|
changes emitted from the current name owner are considered and
|
|
calls are always sent to the current name owner. This avoids a
|
|
number of race conditions when the name is lost by one owner and
|
|
claimed by another. However, if no name owner currently exists,
|
|
then calls will be sent to the well-known name which may result in
|
|
the message bus launching an owner (unless
|
|
%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is set).
|
|
|
|
The generic #GDBusProxy::g-properties-changed and
|
|
#GDBusProxy::g-signal signals are not very convenient to work with.
|
|
Therefore, the recommended way of working with proxies is to subclass
|
|
#GDBusProxy, and have more natural properties and signals in your derived
|
|
class. This [example][gdbus-example-gdbus-codegen] shows how this can
|
|
easily be done using the [gdbus-codegen][gdbus-codegen] tool.
|
|
|
|
A #GDBusProxy instance can be used from multiple threads but note
|
|
that all signals (e.g. #GDBusProxy::g-signal, #GDBusProxy::g-properties-changed
|
|
and #GObject::notify) are emitted in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread where the instance was constructed.
|
|
|
|
An example using a proxy for a well-known name can be found in
|
|
[gdbus-example-watch-proxy.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-watch-proxy.c)</doc>
|
|
<source-position filename="gdbusproxy.h" line="85"/>
|
|
<implements name="AsyncInitable"/>
|
|
<implements name="DBusInterface"/>
|
|
<implements name="Initable"/>
|
|
<constructor name="new_finish" c:identifier="g_dbus_proxy_new_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19015">Finishes creating a #GDBusProxy.</doc>
|
|
<source-position filename="gdbusproxy.h" line="100"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19022">A #GDBusProxy or %NULL if @error is set.
|
|
Free with g_object_unref().</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19017">A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_for_bus_finish" c:identifier="g_dbus_proxy_new_for_bus_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19048">Finishes creating a #GDBusProxy.</doc>
|
|
<source-position filename="gdbusproxy.h" line="122"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19055">A #GDBusProxy or %NULL if @error is set.
|
|
Free with g_object_unref().</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19050">A #GAsyncResult obtained from the #GAsyncReadyCallback function passed to g_dbus_proxy_new_for_bus().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_for_bus_sync" c:identifier="g_dbus_proxy_new_for_bus_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19061">Like g_dbus_proxy_new_sync() but takes a #GBusType instead of a #GDBusConnection.
|
|
|
|
#GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
|
|
<source-position filename="gdbusproxy.h" line="125"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19077">A #GDBusProxy or %NULL if error is set.
|
|
Free with g_object_unref().</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19063">A #GBusType.</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19064">Flags used when constructing the proxy.</doc>
|
|
<type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19065">A #GDBusInterfaceInfo specifying the minimal interface
|
|
that @proxy conforms to or %NULL.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19067">A bus name (well-known or unique).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19068">An object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19069">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19070">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_sync" c:identifier="g_dbus_proxy_new_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19083">Creates a proxy for accessing @interface_name on the remote object
|
|
at @object_path owned by @name at @connection and synchronously
|
|
loads D-Bus properties unless the
|
|
%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used.
|
|
|
|
If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
|
|
match rules for signals. Connect to the #GDBusProxy::g-signal signal
|
|
to handle signals from the remote object.
|
|
|
|
If both %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES and
|
|
%G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS are set, this constructor is
|
|
guaranteed to return immediately without blocking.
|
|
|
|
If @name is a well-known name and the
|
|
%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START and %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION
|
|
flags aren't set and no name owner currently exists, the message bus
|
|
will be requested to launch a name owner for the name.
|
|
|
|
This is a synchronous failable constructor. See g_dbus_proxy_new()
|
|
and g_dbus_proxy_new_finish() for the asynchronous version.
|
|
|
|
#GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
|
|
<source-position filename="gdbusproxy.h" line="103"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19117">A #GDBusProxy or %NULL if error is set.
|
|
Free with g_object_unref().</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19085">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19086">Flags used when constructing the proxy.</doc>
|
|
<type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19087">A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19088">A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19089">An object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19090">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19091">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="new" c:identifier="g_dbus_proxy_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18971">Creates a proxy for accessing @interface_name on the remote object
|
|
at @object_path owned by @name at @connection and asynchronously
|
|
loads D-Bus properties unless the
|
|
%G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES flag is used. Connect to
|
|
the #GDBusProxy::g-properties-changed signal to get notified about
|
|
property changes.
|
|
|
|
If the %G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS flag is not set, also sets up
|
|
match rules for signals. Connect to the #GDBusProxy::g-signal signal
|
|
to handle signals from the remote object.
|
|
|
|
If both %G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES and
|
|
%G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS are set, this constructor is
|
|
guaranteed to complete immediately without blocking.
|
|
|
|
If @name is a well-known name and the
|
|
%G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START and %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION
|
|
flags aren't set and no name owner currently exists, the message bus
|
|
will be requested to launch a name owner for the name.
|
|
|
|
This is a failable asynchronous constructor - when the proxy is
|
|
ready, @callback will be invoked and you can use
|
|
g_dbus_proxy_new_finish() to get the result.
|
|
|
|
See g_dbus_proxy_new_sync() and for a synchronous version of this constructor.
|
|
|
|
#GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
|
|
<source-position filename="gdbusproxy.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18973">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18974">Flags used when constructing the proxy.</doc>
|
|
<type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18975">A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18976">A bus name (well-known or unique) or %NULL if @connection is not a message bus connection.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18977">An object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18978">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18979">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="8">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18980">Callback function to invoke when the proxy is ready.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18981">User data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_bus" c:identifier="g_dbus_proxy_new_for_bus" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19028">Like g_dbus_proxy_new() but takes a #GBusType instead of a #GDBusConnection.
|
|
|
|
#GDBusProxy is used in this [example][gdbus-wellknown-proxy].</doc>
|
|
<source-position filename="gdbusproxy.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19030">A #GBusType.</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19031">Flags used when constructing the proxy.</doc>
|
|
<type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19032">A #GDBusInterfaceInfo specifying the minimal interface that @proxy conforms to or %NULL.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19033">A bus name (well-known or unique).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19034">An object path.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19035">A D-Bus interface name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19036">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="8">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19037">Callback function to invoke when the proxy is ready.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19038">User data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="g_properties_changed">
|
|
<source-position filename="gdbusproxy.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="changed_properties" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="invalidated_properties" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar* const*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="g_signal">
|
|
<source-position filename="gdbusproxy.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="sender_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="call" c:identifier="g_dbus_proxy_call" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18651">Asynchronously invokes the @method_name method on @proxy.
|
|
|
|
If @method_name contains any dots, then @name is split into interface and
|
|
method name parts. This allows using @proxy for invoking methods on
|
|
other interfaces.
|
|
|
|
If the #GDBusConnection associated with @proxy is closed then
|
|
the operation will fail with %G_IO_ERROR_CLOSED. If
|
|
@cancellable is canceled, the operation will fail with
|
|
%G_IO_ERROR_CANCELLED. If @parameters contains a value not
|
|
compatible with the D-Bus protocol, the operation fails with
|
|
%G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
If the @parameters #GVariant is floating, it is consumed. This allows
|
|
convenient 'inline' use of g_variant_new(), e.g.:
|
|
|[<!-- language="C" -->
|
|
g_dbus_proxy_call (proxy,
|
|
"TwoStrings",
|
|
g_variant_new ("(ss)",
|
|
"Thing One",
|
|
"Thing Two"),
|
|
G_DBUS_CALL_FLAGS_NONE,
|
|
-1,
|
|
NULL,
|
|
(GAsyncReadyCallback) two_strings_done,
|
|
&data);
|
|
]|
|
|
|
|
If @proxy has an expected interface (see
|
|
#GDBusProxy:g-interface-info) and @method_name is referenced by it,
|
|
then the return value is checked against the return type.
|
|
|
|
This is an asynchronous method. When the operation is finished,
|
|
@callback will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this method from.
|
|
You can then call g_dbus_proxy_call_finish() to get the result of
|
|
the operation. See g_dbus_proxy_call_sync() for the synchronous
|
|
version of this method.
|
|
|
|
If @callback is %NULL then the D-Bus method call message will be sent with
|
|
the %G_DBUS_MESSAGE_FLAGS_NO_REPLY_EXPECTED flag set.</doc>
|
|
<source-position filename="gdbusproxy.h" line="165"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18653">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18654">Name of method to invoke.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18655">A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18656">Flags from the #GDBusCallFlags enumeration.</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18657">The timeout in milliseconds (with %G_MAXINT meaning
|
|
"infinite") or -1 to use the proxy default timeout.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18659">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18660">A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
|
|
care about the result of the method invocation.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18662">The data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_finish" c:identifier="g_dbus_proxy_call_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18711">Finishes an operation started with g_dbus_proxy_call().</doc>
|
|
<source-position filename="gdbusproxy.h" line="174"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18719">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18713">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18714">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_sync" c:identifier="g_dbus_proxy_call_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18725">Synchronously invokes the @method_name method on @proxy.
|
|
|
|
If @method_name contains any dots, then @name is split into interface and
|
|
method name parts. This allows using @proxy for invoking methods on
|
|
other interfaces.
|
|
|
|
If the #GDBusConnection associated with @proxy is disconnected then
|
|
the operation will fail with %G_IO_ERROR_CLOSED. If
|
|
@cancellable is canceled, the operation will fail with
|
|
%G_IO_ERROR_CANCELLED. If @parameters contains a value not
|
|
compatible with the D-Bus protocol, the operation fails with
|
|
%G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
If the @parameters #GVariant is floating, it is consumed. This allows
|
|
convenient 'inline' use of g_variant_new(), e.g.:
|
|
|[<!-- language="C" -->
|
|
g_dbus_proxy_call_sync (proxy,
|
|
"TwoStrings",
|
|
g_variant_new ("(ss)",
|
|
"Thing One",
|
|
"Thing Two"),
|
|
G_DBUS_CALL_FLAGS_NONE,
|
|
-1,
|
|
NULL,
|
|
&error);
|
|
]|
|
|
|
|
The calling thread is blocked until a reply is received. See
|
|
g_dbus_proxy_call() for the asynchronous version of this
|
|
method.
|
|
|
|
If @proxy has an expected interface (see
|
|
#GDBusProxy:g-interface-info) and @method_name is referenced by it,
|
|
then the return value is checked against the return type.</doc>
|
|
<source-position filename="gdbusproxy.h" line="178"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18772">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18727">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18728">Name of method to invoke.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18729">A #GVariant tuple with parameters for the signal
|
|
or %NULL if not passing parameters.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18731">Flags from the #GDBusCallFlags enumeration.</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18732">The timeout in milliseconds (with %G_MAXINT meaning
|
|
"infinite") or -1 to use the proxy default timeout.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18734">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_with_unix_fd_list" c:identifier="g_dbus_proxy_call_with_unix_fd_list" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18778">Like g_dbus_proxy_call() but also takes a #GUnixFDList object.
|
|
|
|
This method is only available on UNIX.</doc>
|
|
<source-position filename="gdbusproxy.h" line="187"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18780">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18781">Name of method to invoke.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18782">A #GVariant tuple with parameters for the signal or %NULL if not passing parameters.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18783">Flags from the #GDBusCallFlags enumeration.</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18784">The timeout in milliseconds (with %G_MAXINT meaning
|
|
"infinite") or -1 to use the proxy default timeout.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="fd_list" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18786">A #GUnixFDList or %NULL.</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18787">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18788">A #GAsyncReadyCallback to call when the request is satisfied or %NULL if you don't
|
|
care about the result of the method invocation.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18790">The data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_with_unix_fd_list_finish" c:identifier="g_dbus_proxy_call_with_unix_fd_list_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18800">Finishes an operation started with g_dbus_proxy_call_with_unix_fd_list().</doc>
|
|
<source-position filename="gdbusproxy.h" line="197"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18809">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18802">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_fd_list" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18803">Return location for a #GUnixFDList or %NULL.</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList**"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18804">A #GAsyncResult obtained from the #GAsyncReadyCallback passed to g_dbus_proxy_call_with_unix_fd_list().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="call_with_unix_fd_list_sync" c:identifier="g_dbus_proxy_call_with_unix_fd_list_sync" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18815">Like g_dbus_proxy_call_sync() but also takes and returns #GUnixFDList objects.
|
|
|
|
This method is only available on UNIX.</doc>
|
|
<source-position filename="gdbusproxy.h" line="202"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18833">%NULL if @error is set. Otherwise a #GVariant tuple with
|
|
return values. Free with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18817">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="method_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18818">Name of method to invoke.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18819">A #GVariant tuple with parameters for the signal
|
|
or %NULL if not passing parameters.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18821">Flags from the #GDBusCallFlags enumeration.</doc>
|
|
<type name="DBusCallFlags" c:type="GDBusCallFlags"/>
|
|
</parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18822">The timeout in milliseconds (with %G_MAXINT meaning
|
|
"infinite") or -1 to use the proxy default timeout.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="fd_list" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18824">A #GUnixFDList or %NULL.</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</parameter>
|
|
<parameter name="out_fd_list" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18825">Return location for a #GUnixFDList or %NULL.</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18826">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_cached_property" c:identifier="g_dbus_proxy_get_cached_property" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18839">Looks up the value for a property from the cache. This call does no
|
|
blocking IO.
|
|
|
|
If @proxy has an expected interface (see
|
|
#GDBusProxy:g-interface-info) and @property_name is referenced by
|
|
it, then @value is checked against the type of the property.</doc>
|
|
<source-position filename="gdbusproxy.h" line="156"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18851">A reference to the #GVariant instance
|
|
that holds the value for @property_name or %NULL if the value is not in
|
|
the cache. The returned reference must be freed with g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18841">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="property_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18842">Property name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_cached_property_names" c:identifier="g_dbus_proxy_get_cached_property_names" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18858">Gets the names of all cached properties on @proxy.</doc>
|
|
<source-position filename="gdbusproxy.h" line="163"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18864">A
|
|
%NULL-terminated array of strings or %NULL if
|
|
@proxy has no cached properties. Free the returned array with
|
|
g_strfreev().</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18860">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_connection" c:identifier="g_dbus_proxy_get_connection" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18872">Gets the connection @proxy is for.</doc>
|
|
<source-position filename="gdbusproxy.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18878">A #GDBusConnection owned by @proxy. Do not free.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18874">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_default_timeout" c:identifier="g_dbus_proxy_get_default_timeout" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18883">Gets the timeout to use if -1 (specifying default timeout) is
|
|
passed as @timeout_msec in the g_dbus_proxy_call() and
|
|
g_dbus_proxy_call_sync() functions.
|
|
|
|
See the #GDBusProxy:g-default-timeout property for more details.</doc>
|
|
<source-position filename="gdbusproxy.h" line="146"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18893">Timeout to use for @proxy.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18885">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_dbus_proxy_get_flags" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18898">Gets the flags that @proxy was constructed with.</doc>
|
|
<source-position filename="gdbusproxy.h" line="136"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18904">Flags from the #GDBusProxyFlags enumeration.</doc>
|
|
<type name="DBusProxyFlags" c:type="GDBusProxyFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18900">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_interface_info" c:identifier="g_dbus_proxy_get_interface_info" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18909">Returns the #GDBusInterfaceInfo, if any, specifying the interface
|
|
that @proxy conforms to. See the #GDBusProxy:g-interface-info
|
|
property for more details.</doc>
|
|
<source-position filename="gdbusproxy.h" line="151"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18917">A #GDBusInterfaceInfo or %NULL.
|
|
Do not unref the returned object, it is owned by @proxy.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18911">A #GDBusProxy</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_interface_name" c:identifier="g_dbus_proxy_get_interface_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18923">Gets the D-Bus interface name @proxy is for.</doc>
|
|
<source-position filename="gdbusproxy.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18929">A string owned by @proxy. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18925">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_dbus_proxy_get_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18934">Gets the name that @proxy was constructed for.</doc>
|
|
<source-position filename="gdbusproxy.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18940">A string owned by @proxy. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18936">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name_owner" c:identifier="g_dbus_proxy_get_name_owner" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18945">The unique name that owns the name that @proxy is for or %NULL if
|
|
no-one currently owns that name. You may connect to the
|
|
#GObject::notify signal to track changes to the
|
|
#GDBusProxy:g-name-owner property.</doc>
|
|
<source-position filename="gdbusproxy.h" line="140"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18954">The name owner or %NULL if no name
|
|
owner exists. Free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18947">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object_path" c:identifier="g_dbus_proxy_get_object_path" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18960">Gets the object path @proxy is for.</doc>
|
|
<source-position filename="gdbusproxy.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18966">A string owned by @proxy. Do not free.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="18962">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_cached_property" c:identifier="g_dbus_proxy_set_cached_property" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19123">If @value is not %NULL, sets the cached value for the property with
|
|
name @property_name to the value in @value.
|
|
|
|
If @value is %NULL, then the cached value is removed from the
|
|
property cache.
|
|
|
|
If @proxy has an expected interface (see
|
|
#GDBusProxy:g-interface-info) and @property_name is referenced by
|
|
it, then @value is checked against the type of the property.
|
|
|
|
If the @value #GVariant is floating, it is consumed. This allows
|
|
convenient 'inline' use of g_variant_new(), e.g.
|
|
|[<!-- language="C" -->
|
|
g_dbus_proxy_set_cached_property (proxy,
|
|
"SomeProperty",
|
|
g_variant_new ("(si)",
|
|
"A String",
|
|
42));
|
|
]|
|
|
|
|
Normally you will not need to use this method since @proxy
|
|
is tracking changes using the
|
|
`org.freedesktop.DBus.Properties.PropertiesChanged`
|
|
D-Bus signal. However, for performance reasons an object may
|
|
decide to not use this signal for some properties and instead
|
|
use a proprietary out-of-band mechanism to transmit changes.
|
|
|
|
As a concrete example, consider an object with a property
|
|
`ChatroomParticipants` which is an array of strings. Instead of
|
|
transmitting the same (long) array every time the property changes,
|
|
it is more efficient to only transmit the delta using e.g. signals
|
|
`ChatroomParticipantJoined(String name)` and
|
|
`ChatroomParticipantParted(String name)`.</doc>
|
|
<source-position filename="gdbusproxy.h" line="159"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19125">A #GDBusProxy</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="property_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19126">Property name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19127">Value for the property or %NULL to remove it from the cache.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_default_timeout" c:identifier="g_dbus_proxy_set_default_timeout" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19167">Sets the timeout to use if -1 (specifying default timeout) is
|
|
passed as @timeout_msec in the g_dbus_proxy_call() and
|
|
g_dbus_proxy_call_sync() functions.
|
|
|
|
See the #GDBusProxy:g-default-timeout property for more details.</doc>
|
|
<source-position filename="gdbusproxy.h" line="148"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19169">A #GDBusProxy.</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="timeout_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19170">Timeout in milliseconds.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_interface_info" c:identifier="g_dbus_proxy_set_interface_info" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19182">Ensure that interactions with @proxy conform to the given
|
|
interface. See the #GDBusProxy:g-interface-info property for more
|
|
details.</doc>
|
|
<source-position filename="gdbusproxy.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19184">A #GDBusProxy</doc>
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19185">Minimum interface this proxy conforms to
|
|
or %NULL to unset.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="g-bus-type" version="2.26" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1222">If this property is not %G_BUS_TYPE_NONE, then
|
|
#GDBusProxy:g-connection must be %NULL and will be set to the
|
|
#GDBusConnection obtained by calling g_bus_get() with the value
|
|
of this property.</doc>
|
|
<type name="BusType"/>
|
|
</property>
|
|
<property name="g-connection" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1234">The #GDBusConnection the proxy is for.</doc>
|
|
<type name="DBusConnection"/>
|
|
</property>
|
|
<property name="g-default-timeout" version="2.26" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1243">The timeout to use if -1 (specifying default timeout) is passed
|
|
as @timeout_msec in the g_dbus_proxy_call() and
|
|
g_dbus_proxy_call_sync() functions.
|
|
|
|
This allows applications to set a proxy-wide timeout for all
|
|
remote method invocations on the proxy. If this property is -1,
|
|
the default timeout (typically 25 seconds) is used. If set to
|
|
%G_MAXINT, then no timeout is used.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<property name="g-flags" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1259">Flags from the #GDBusProxyFlags enumeration.</doc>
|
|
<type name="DBusProxyFlags"/>
|
|
</property>
|
|
<property name="g-interface-info" version="2.26" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1268">Ensure that interactions with this proxy conform to the given
|
|
interface. This is mainly to ensure that malformed data received
|
|
from the other peer is ignored. The given #GDBusInterfaceInfo is
|
|
said to be the "expected interface".
|
|
|
|
The checks performed are:
|
|
- When completing a method call, if the type signature of
|
|
the reply message isn't what's expected, the reply is
|
|
discarded and the #GError is set to %G_IO_ERROR_INVALID_ARGUMENT.
|
|
|
|
- Received signals that have a type signature mismatch are dropped and
|
|
a warning is logged via g_warning().
|
|
|
|
- Properties received via the initial `GetAll()` call or via the
|
|
`::PropertiesChanged` signal (on the
|
|
[org.freedesktop.DBus.Properties](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties)
|
|
interface) or set using g_dbus_proxy_set_cached_property()
|
|
with a type signature mismatch are ignored and a warning is
|
|
logged via g_warning().
|
|
|
|
Note that these checks are never done on methods, signals and
|
|
properties that are not referenced in the given
|
|
#GDBusInterfaceInfo, since extending a D-Bus interface on the
|
|
service-side is not considered an ABI break.</doc>
|
|
<type name="DBusInterfaceInfo"/>
|
|
</property>
|
|
<property name="g-interface-name" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1300">The D-Bus interface name the proxy is for.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="g-name" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1309">The well-known or unique name that the proxy is for.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="g-name-owner" version="2.26" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1318">The unique name that owns #GDBusProxy:g-name or %NULL if no-one
|
|
currently owns that name. You may connect to #GObject::notify signal to
|
|
track changes to this property.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="g-object-path" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1329">The object path the proxy is for.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DBusProxyPrivate" c:type="GDBusProxyPrivate*"/>
|
|
</field>
|
|
<glib:signal name="g-properties-changed" when="last" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1186">Emitted when one or more D-Bus properties on @proxy changes. The
|
|
local cache has already been updated when this signal fires. Note
|
|
that both @changed_properties and @invalidated_properties are
|
|
guaranteed to never be %NULL (either may be empty though).
|
|
|
|
If the proxy has the flag
|
|
%G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES set, then
|
|
@invalidated_properties will always be empty.
|
|
|
|
This signal corresponds to the
|
|
`PropertiesChanged` D-Bus signal on the
|
|
`org.freedesktop.DBus.Properties` interface.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="changed_properties" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1189">A #GVariant containing the properties that changed (type: `a{sv}`)</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
<parameter name="invalidated_properties" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1190">A %NULL terminated array of properties that was invalidated</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="g-signal" when="last" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1209">Emitted when a signal from the remote object and interface that @proxy is for, has been received.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="sender_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1212">The sender of the signal or %NULL if the connection is not a bus connection.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1213">The name of the signal.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1214">A #GVariant tuple with parameters for the signal.</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="DBusProxyClass" c:type="GDBusProxyClass" glib:is-gtype-struct-for="DBusProxy" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusproxy.h" line="58">Class structure for #GDBusProxy.</doc>
|
|
<source-position filename="gdbusproxy.h" line="85"/>
|
|
<field name="parent_class" readable="0" private="1">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="g_properties_changed">
|
|
<callback name="g_properties_changed">
|
|
<source-position filename="gdbusproxy.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</parameter>
|
|
<parameter name="changed_properties" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="invalidated_properties" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar* const*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="g_signal">
|
|
<callback name="g_signal">
|
|
<source-position filename="gdbusproxy.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="proxy" transfer-ownership="none">
|
|
<type name="DBusProxy" c:type="GDBusProxy*"/>
|
|
</parameter>
|
|
<parameter name="sender_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="32">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<bitfield name="DBusProxyFlags" version="2.26" glib:type-name="GDBusProxyFlags" glib:get-type="g_dbus_proxy_flags_get_type" c:type="GDBusProxyFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1009">Flags used when constructing an instance of a #GDBusProxy derived class.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_PROXY_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1011">No flags set.</doc>
|
|
</member>
|
|
<member name="do_not_load_properties" value="1" c:identifier="G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES" glib:nick="do-not-load-properties">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1012">Don't load properties.</doc>
|
|
</member>
|
|
<member name="do_not_connect_signals" value="2" c:identifier="G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS" glib:nick="do-not-connect-signals">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1013">Don't connect to signals on the remote object.</doc>
|
|
</member>
|
|
<member name="do_not_auto_start" value="4" c:identifier="G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START" glib:nick="do-not-auto-start">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1014">If the proxy is for a well-known name,
|
|
do not ask the bus to launch an owner during proxy initialization or a method call.
|
|
This flag is only meaningful in proxies for well-known names.</doc>
|
|
</member>
|
|
<member name="get_invalidated_properties" value="8" c:identifier="G_DBUS_PROXY_FLAGS_GET_INVALIDATED_PROPERTIES" glib:nick="get-invalidated-properties">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1017">If set, the property value for any __invalidated property__ will be (asynchronously) retrieved upon receiving the [`PropertiesChanged`](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties) D-Bus signal and the property will not cause emission of the #GDBusProxy::g-properties-changed signal. When the value is received the #GDBusProxy::g-properties-changed signal is emitted for the property along with the retrieved value. Since 2.32.</doc>
|
|
</member>
|
|
<member name="do_not_auto_start_at_construction" value="16" c:identifier="G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START_AT_CONSTRUCTION" glib:nick="do-not-auto-start-at-construction">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1018">If the proxy is for a well-known name,
|
|
do not ask the bus to launch an owner during proxy initialization, but allow it to be
|
|
autostarted by a method call. This flag is only meaningful in proxies for well-known names,
|
|
and only if %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is not also specified.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="DBusProxyPrivate" c:type="GDBusProxyPrivate" disguised="1">
|
|
<source-position filename="gdbusproxy.h" line="41"/>
|
|
</record>
|
|
<callback name="DBusProxyTypeFunc" c:type="GDBusProxyTypeFunc" version="2.30">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="607">Function signature for a function used to determine the #GType to
|
|
use for an interface proxy (if @interface_name is not %NULL) or
|
|
object proxy (if @interface_name is %NULL).
|
|
|
|
This function is called in the
|
|
[thread-default main loop][g-main-context-push-thread-default]
|
|
that @manager was constructed in.</doc>
|
|
<source-position filename="giotypes.h" line="628"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="622">A #GType to use for the remote object. The returned type
|
|
must be a #GDBusProxy or #GDBusObjectProxy -derived
|
|
type.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="manager" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="609">A #GDBusObjectManagerClient.</doc>
|
|
<type name="DBusObjectManagerClient" c:type="GDBusObjectManagerClient*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="610">The object path of the remote object.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="611">The interface name of the remote object or %NULL if a #GDBusObjectProxy #GType is requested.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="612">User data.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="DBusSendMessageFlags" version="2.26" glib:type-name="GDBusSendMessageFlags" glib:get-type="g_dbus_send_message_flags_get_type" c:type="GDBusSendMessageFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1405">Flags used when sending #GDBusMessages on a #GDBusConnection.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_SEND_MESSAGE_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1407">No flags set.</doc>
|
|
</member>
|
|
<member name="preserve_serial" value="1" c:identifier="G_DBUS_SEND_MESSAGE_FLAGS_PRESERVE_SERIAL" glib:nick="preserve-serial">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1408">Do not automatically
|
|
assign a serial number from the #GDBusConnection object when
|
|
sending a message.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<class name="DBusServer" c:symbol-prefix="dbus_server" c:type="GDBusServer" version="2.26" parent="GObject.Object" glib:type-name="GDBusServer" glib:get-type="g_dbus_server_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5968">#GDBusServer is a helper for listening to and accepting D-Bus
|
|
connections. This can be used to create a new D-Bus server, allowing two
|
|
peers to use the D-Bus protocol for their own specialized communication.
|
|
A server instance provided in this way will not perform message routing or
|
|
implement the org.freedesktop.DBus interface.
|
|
|
|
To just export an object on a well-known name on a message bus, such as the
|
|
session or system bus, you should instead use g_bus_own_name().
|
|
|
|
An example of peer-to-peer communication with G-DBus can be found
|
|
in [gdbus-example-peer.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-example-peer.c).
|
|
|
|
Note that a minimal #GDBusServer will accept connections from any
|
|
peer. In many use-cases it will be necessary to add a #GDBusAuthObserver
|
|
that only accepts connections that have successfully authenticated
|
|
as the same user that is running the #GDBusServer.</doc>
|
|
<implements name="Initable"/>
|
|
<constructor name="new_sync" c:identifier="g_dbus_server_new_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19243">Creates a new D-Bus server that listens on the first address in
|
|
@address that works.
|
|
|
|
Once constructed, you can use g_dbus_server_get_client_address() to
|
|
get a D-Bus address string that clients can use to connect.
|
|
|
|
To have control over the available authentication mechanisms and
|
|
the users that are authorized to connect, it is strongly recommended
|
|
to provide a non-%NULL #GDBusAuthObserver.
|
|
|
|
Connect to the #GDBusServer::new-connection signal to handle
|
|
incoming connections.
|
|
|
|
The returned #GDBusServer isn't active - you have to start it with
|
|
g_dbus_server_start().
|
|
|
|
#GDBusServer is used in this [example][gdbus-peer-to-peer].
|
|
|
|
This is a synchronous failable constructor. There is currently no
|
|
asynchronous version.</doc>
|
|
<source-position filename="gdbusserver.h" line="39"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19273">A #GDBusServer or %NULL if @error is set. Free with
|
|
g_object_unref().</doc>
|
|
<type name="DBusServer" c:type="GDBusServer*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19245">A D-Bus address.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19246">Flags from the #GDBusServerFlags enumeration.</doc>
|
|
<type name="DBusServerFlags" c:type="GDBusServerFlags"/>
|
|
</parameter>
|
|
<parameter name="guid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19247">A D-Bus GUID.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="observer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19248">A #GDBusAuthObserver or %NULL.</doc>
|
|
<type name="DBusAuthObserver" c:type="GDBusAuthObserver*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19249">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_client_address" c:identifier="g_dbus_server_get_client_address" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19196">Gets a
|
|
[D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses)
|
|
string that can be used by clients to connect to @server.</doc>
|
|
<source-position filename="gdbusserver.h" line="46"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19204">A D-Bus address string. Do not free, the string is owned
|
|
by @server.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="server" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19198">A #GDBusServer.</doc>
|
|
<type name="DBusServer" c:type="GDBusServer*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_dbus_server_get_flags" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19210">Gets the flags for @server.</doc>
|
|
<source-position filename="gdbusserver.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19216">A set of flags from the #GDBusServerFlags enumeration.</doc>
|
|
<type name="DBusServerFlags" c:type="GDBusServerFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="server" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19212">A #GDBusServer.</doc>
|
|
<type name="DBusServer" c:type="GDBusServer*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_guid" c:identifier="g_dbus_server_get_guid" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19221">Gets the GUID for @server.</doc>
|
|
<source-position filename="gdbusserver.h" line="48"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19227">A D-Bus GUID. Do not free this string, it is owned by @server.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="server" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19223">A #GDBusServer.</doc>
|
|
<type name="DBusServer" c:type="GDBusServer*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_active" c:identifier="g_dbus_server_is_active" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19232">Gets whether @server is active.</doc>
|
|
<source-position filename="gdbusserver.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19238">%TRUE if server is active, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="server" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19234">A #GDBusServer.</doc>
|
|
<type name="DBusServer" c:type="GDBusServer*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start" c:identifier="g_dbus_server_start" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19279">Starts @server.</doc>
|
|
<source-position filename="gdbusserver.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="server" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19281">A #GDBusServer.</doc>
|
|
<type name="DBusServer" c:type="GDBusServer*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop" c:identifier="g_dbus_server_stop" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19289">Stops @server.</doc>
|
|
<source-position filename="gdbusserver.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="server" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19291">A #GDBusServer.</doc>
|
|
<type name="DBusServer" c:type="GDBusServer*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="active" version="2.26" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1381">Whether the server is currently active.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="address" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1390">The D-Bus address to listen on.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="authentication-observer" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1399">A #GDBusAuthObserver object to assist in the authentication process or %NULL.</doc>
|
|
<type name="DBusAuthObserver"/>
|
|
</property>
|
|
<property name="client-address" version="2.26" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1408">The D-Bus address that clients can use.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="flags" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1417">Flags from the #GDBusServerFlags enumeration.</doc>
|
|
<type name="DBusServerFlags"/>
|
|
</property>
|
|
<property name="guid" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1426">The guid of the server.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<glib:signal name="new-connection" when="last" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1348">Emitted when a new authenticated connection has been made. Use
|
|
g_dbus_connection_get_peer_credentials() to figure out what
|
|
identity (if any), was authenticated.
|
|
|
|
If you want to accept the connection, take a reference to the
|
|
@connection object and return %TRUE. When you are done with the
|
|
connection call g_dbus_connection_close() and give up your
|
|
reference. Note that the other peer may disconnect at any time -
|
|
a typical thing to do when accepting a connection is to listen to
|
|
the #GDBusConnection::closed signal.
|
|
|
|
If #GDBusServer:flags contains %G_DBUS_SERVER_FLAGS_RUN_IN_THREAD
|
|
then the signal is emitted in a new thread dedicated to the
|
|
connection. Otherwise the signal is emitted in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread that @server was constructed in.
|
|
|
|
You are guaranteed that signal handlers for this signal runs
|
|
before incoming messages on @connection are processed. This means
|
|
that it's suitable to call g_dbus_connection_register_object() or
|
|
similar from the signal handler.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1375">%TRUE to claim @connection, %FALSE to let other handlers
|
|
run.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1351">A #GDBusConnection for the new connection.</doc>
|
|
<type name="DBusConnection"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<bitfield name="DBusServerFlags" version="2.26" glib:type-name="GDBusServerFlags" glib:get-type="g_dbus_server_flags_get_type" c:type="GDBusServerFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1361">Flags used when creating a #GDBusServer.</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_SERVER_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1363">No flags set.</doc>
|
|
</member>
|
|
<member name="run_in_thread" value="1" c:identifier="G_DBUS_SERVER_FLAGS_RUN_IN_THREAD" glib:nick="run-in-thread">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1364">All #GDBusServer::new-connection
|
|
signals will run in separated dedicated threads (see signal for
|
|
details).</doc>
|
|
</member>
|
|
<member name="authentication_allow_anonymous" value="2" c:identifier="G_DBUS_SERVER_FLAGS_AUTHENTICATION_ALLOW_ANONYMOUS" glib:nick="authentication-allow-anonymous">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1367">Allow the anonymous
|
|
authentication method.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<callback name="DBusSignalCallback" c:type="GDBusSignalCallback" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="550">Signature for callback function used in g_dbus_connection_signal_subscribe().</doc>
|
|
<source-position filename="gdbusconnection.h" line="564"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="552">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="sender_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="553">The unique bus name of the sender of the signal.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="554">The object path that the signal was emitted on.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="555">The name of the interface.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="signal_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="556">The name of the signal.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="557">A #GVariant tuple with parameters for the signal.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="558">User data passed when subscribing to the signal.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="DBusSignalFlags" version="2.26" glib:type-name="GDBusSignalFlags" glib:get-type="g_dbus_signal_flags_get_type" c:type="GDBusSignalFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1381">Flags used when subscribing to signals via g_dbus_connection_signal_subscribe().</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_SIGNAL_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1383">No flags set.</doc>
|
|
</member>
|
|
<member name="no_match_rule" value="1" c:identifier="G_DBUS_SIGNAL_FLAGS_NO_MATCH_RULE" glib:nick="no-match-rule">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1384">Don't actually send the AddMatch
|
|
D-Bus call for this signal subscription. This gives you more control
|
|
over which match rules you add (but you must add them manually).</doc>
|
|
</member>
|
|
<member name="match_arg0_namespace" value="2" c:identifier="G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_NAMESPACE" glib:nick="match-arg0-namespace">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1387">Match first arguments that
|
|
contain a bus or interface name with the given namespace.</doc>
|
|
</member>
|
|
<member name="match_arg0_path" value="4" c:identifier="G_DBUS_SIGNAL_FLAGS_MATCH_ARG0_PATH" glib:nick="match-arg0-path">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1389">Match first arguments that
|
|
contain an object path that is either equivalent to the given path,
|
|
or one of the paths is a subpath of the other.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="DBusSignalInfo" c:type="GDBusSignalInfo" version="2.26" glib:type-name="GDBusSignalInfo" glib:get-type="g_dbus_signal_info_get_type" c:symbol-prefix="dbus_signal_info">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="94">Information about a signal on a D-Bus interface.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="112"/>
|
|
<field name="ref_count" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="96">The reference count or -1 if statically allocated.</doc>
|
|
<type name="gint" c:type="volatile gint"/>
|
|
</field>
|
|
<field name="name" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="97">The name of the D-Bus signal, e.g. "NameOwnerChanged".</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</field>
|
|
<field name="args" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="98">A pointer to a %NULL-terminated array of pointers to #GDBusArgInfo structures or %NULL if there are no arguments.</doc>
|
|
<array c:type="GDBusArgInfo**">
|
|
<type name="DBusArgInfo" c:type="GDBusArgInfo*"/>
|
|
</array>
|
|
</field>
|
|
<field name="annotations" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusintrospection.h" line="99">A pointer to a %NULL-terminated array of pointers to #GDBusAnnotationInfo structures or %NULL if there are no annotations.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</field>
|
|
<method name="ref" c:identifier="g_dbus_signal_info_ref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19299">If @info is statically allocated does nothing. Otherwise increases
|
|
the reference count.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="222"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19306">The same @info.</doc>
|
|
<type name="DBusSignalInfo" c:type="GDBusSignalInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19301">A #GDBusSignalInfo</doc>
|
|
<type name="DBusSignalInfo" c:type="GDBusSignalInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_dbus_signal_info_unref" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19311">If @info is statically allocated, does nothing. Otherwise decreases
|
|
the reference count of @info. When its reference count drops to 0,
|
|
the memory used is freed.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="237"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19313">A #GDBusSignalInfo.</doc>
|
|
<type name="DBusSignalInfo" c:type="GDBusSignalInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<callback name="DBusSubtreeDispatchFunc" c:type="GDBusSubtreeDispatchFunc" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="485">The type of the @dispatch function in #GDBusSubtreeVTable.
|
|
|
|
Subtrees are flat. @node, if non-%NULL, is always exactly one
|
|
segment of the object path (ie: it never contains a slash).</doc>
|
|
<source-position filename="gdbusconnection.h" line="504"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="500">A #GDBusInterfaceVTable or %NULL if you don't want to handle the methods.</doc>
|
|
<type name="DBusInterfaceVTable" c:type="const GDBusInterfaceVTable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="487">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="sender" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="488">The unique bus name of the remote caller.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="489">The object path that was registered with g_dbus_connection_register_subtree().</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interface_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="490">The D-Bus interface name that the method call or property access is for.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="node" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="491">A node that is a child of @object_path (relative to @object_path) or %NULL for the root of the subtree.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="out_user_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="492">Return location for user data to pass to functions in the returned #GDBusInterfaceVTable (never %NULL).</doc>
|
|
<type name="gpointer" c:type="gpointer*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="493">The @user_data #gpointer passed to g_dbus_connection_register_subtree().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="DBusSubtreeEnumerateFunc" c:type="GDBusSubtreeEnumerateFunc" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="420">The type of the @enumerate function in #GDBusSubtreeVTable.
|
|
|
|
This function is called when generating introspection data and also
|
|
when preparing to dispatch incoming messages in the event that the
|
|
%G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES flag is not
|
|
specified (ie: to verify that the object path is valid).
|
|
|
|
Hierarchies are not supported; the items that you return should not
|
|
contain the '/' character.
|
|
|
|
The return value will be freed with g_strfreev().</doc>
|
|
<source-position filename="gdbusconnection.h" line="443"/>
|
|
<return-value>
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="439">A newly allocated array of strings for node names that are children of @object_path.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="422">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="sender" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="423">The unique bus name of the remote caller.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="424">The object path that was registered with g_dbus_connection_register_subtree().</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="425">The @user_data #gpointer passed to g_dbus_connection_register_subtree().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="DBusSubtreeFlags" version="2.26" glib:type-name="GDBusSubtreeFlags" glib:get-type="g_dbus_subtree_flags_get_type" c:type="GDBusSubtreeFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1344">Flags passed to g_dbus_connection_register_subtree().</doc>
|
|
<member name="none" value="0" c:identifier="G_DBUS_SUBTREE_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1346">No flags set.</doc>
|
|
</member>
|
|
<member name="dispatch_to_unenumerated_nodes" value="1" c:identifier="G_DBUS_SUBTREE_FLAGS_DISPATCH_TO_UNENUMERATED_NODES" glib:nick="dispatch-to-unenumerated-nodes">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1347">Method calls to objects not in the enumerated range
|
|
will still be dispatched. This is useful if you want
|
|
to dynamically spawn objects in the subtree.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<callback name="DBusSubtreeIntrospectFunc" c:type="GDBusSubtreeIntrospectFunc" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="448">The type of the @introspect function in #GDBusSubtreeVTable.
|
|
|
|
Subtrees are flat. @node, if non-%NULL, is always exactly one
|
|
segment of the object path (ie: it never contains a slash).
|
|
|
|
This function should return %NULL to indicate that there is no object
|
|
at this node.
|
|
|
|
If this function returns non-%NULL, the return value is expected to
|
|
be a %NULL-terminated array of pointers to #GDBusInterfaceInfo
|
|
structures describing the interfaces implemented by @node. This
|
|
array will have g_dbus_interface_info_unref() called on each item
|
|
before being freed with g_free().
|
|
|
|
The difference between returning %NULL and an array containing zero
|
|
items is that the standard DBus interfaces will returned to the
|
|
remote introspector in the empty array case, but not in the %NULL
|
|
case.</doc>
|
|
<source-position filename="gdbusconnection.h" line="479"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="475">A %NULL-terminated array of pointers to #GDBusInterfaceInfo, or %NULL.</doc>
|
|
<type name="DBusInterfaceInfo" c:type="GDBusInterfaceInfo**"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="450">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="sender" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="451">The unique bus name of the remote caller.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="452">The object path that was registered with g_dbus_connection_register_subtree().</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="node" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="453">A node that is a child of @object_path (relative to @object_path) or %NULL for the root of the subtree.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="454">The @user_data #gpointer passed to g_dbus_connection_register_subtree().</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="DBusSubtreeVTable" c:type="GDBusSubtreeVTable" version="2.26">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="512">Virtual table for handling subtrees registered with g_dbus_connection_register_subtree().</doc>
|
|
<source-position filename="gdbusconnection.h" line="534"/>
|
|
<field name="enumerate" introspectable="0" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="514">Function for enumerating child nodes.</doc>
|
|
<type name="DBusSubtreeEnumerateFunc" c:type="GDBusSubtreeEnumerateFunc"/>
|
|
</field>
|
|
<field name="introspect" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="515">Function for introspecting a child node.</doc>
|
|
<type name="DBusSubtreeIntrospectFunc" c:type="GDBusSubtreeIntrospectFunc"/>
|
|
</field>
|
|
<field name="dispatch" writable="1">
|
|
<doc xml:space="preserve" filename="gdbusconnection.h" line="516">Function for dispatching a remote call on a child node.</doc>
|
|
<type name="DBusSubtreeDispatchFunc" c:type="GDBusSubtreeDispatchFunc"/>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<function-macro name="DESKTOP_APP_INFO" c:identifier="G_DESKTOP_APP_INFO" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DESKTOP_APP_INFO_CLASS" c:identifier="G_DESKTOP_APP_INFO_CLASS" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DESKTOP_APP_INFO_GET_CLASS" c:identifier="G_DESKTOP_APP_INFO_GET_CLASS" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DESKTOP_APP_INFO_LOOKUP" c:identifier="G_DESKTOP_APP_INFO_LOOKUP" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="110"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME" value="gio-desktop-app-info-lookup" c:type="G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME" deprecated="1" deprecated-version="2.28">
|
|
<doc xml:space="preserve" filename="gdesktopappinfo.h" line="114">Extension point for default handler to URI association. See
|
|
[Extending GIO][extending-gio].</doc>
|
|
<doc-deprecated xml:space="preserve">The #GDesktopAppInfoLookup interface is deprecated and
|
|
unused by GIO.</doc-deprecated>
|
|
<source-position filename="gdesktopappinfo.h" line="123"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="DESKTOP_APP_INFO_LOOKUP_GET_IFACE" c:identifier="G_DESKTOP_APP_INFO_LOOKUP_GET_IFACE" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="112"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DRIVE" c:identifier="G_DRIVE" introspectable="0">
|
|
<source-position filename="gdrive.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DRIVE_GET_IFACE" c:identifier="G_DRIVE_GET_IFACE" introspectable="0">
|
|
<source-position filename="gdrive.h" line="45"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="DRIVE_IDENTIFIER_KIND_UNIX_DEVICE" value="unix-device" c:type="G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE" version="2.58">
|
|
<doc xml:space="preserve" filename="gdrive.h" line="33">The string used to obtain a Unix device path with g_drive_get_identifier().</doc>
|
|
<source-position filename="gdrive.h" line="40"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="DTLS_CLIENT_CONNECTION" c:identifier="G_DTLS_CLIENT_CONNECTION" introspectable="0">
|
|
<source-position filename="gdtlsclientconnection.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DTLS_CLIENT_CONNECTION_GET_INTERFACE" c:identifier="G_DTLS_CLIENT_CONNECTION_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gdtlsclientconnection.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DTLS_CONNECTION" c:identifier="G_DTLS_CONNECTION" introspectable="0">
|
|
<source-position filename="gdtlsconnection.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DTLS_CONNECTION_GET_INTERFACE" c:identifier="G_DTLS_CONNECTION_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gdtlsconnection.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DTLS_SERVER_CONNECTION" c:identifier="G_DTLS_SERVER_CONNECTION" introspectable="0">
|
|
<source-position filename="gdtlsserverconnection.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="DTLS_SERVER_CONNECTION_GET_INTERFACE" c:identifier="G_DTLS_SERVER_CONNECTION_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gdtlsserverconnection.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="DataInputStream" c:symbol-prefix="data_input_stream" c:type="GDataInputStream" parent="BufferedInputStream" glib:type-name="GDataInputStream" glib:get-type="g_data_input_stream_get_type" glib:type-struct="DataInputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5404">Data input stream implements #GInputStream and includes functions for
|
|
reading structured data directly from a binary input stream.</doc>
|
|
<source-position filename="gdatainputstream.h" line="67"/>
|
|
<implements name="Seekable"/>
|
|
<constructor name="new" c:identifier="g_data_input_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14163">Creates a new data input stream for the @base_stream.</doc>
|
|
<source-position filename="gdatainputstream.h" line="72"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14169">a new #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14165">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_byte_order" c:identifier="g_data_input_stream_get_byte_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14143">Gets the byte order for the data input stream.</doc>
|
|
<source-position filename="gdatainputstream.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14149">the @stream's current #GDataStreamByteOrder.</doc>
|
|
<type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14145">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_newline_type" c:identifier="g_data_input_stream_get_newline_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14153">Gets the current newline type for the @stream.</doc>
|
|
<source-position filename="gdatainputstream.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14159">#GDataStreamNewlineType for the given @stream.</doc>
|
|
<type name="DataStreamNewlineType" c:type="GDataStreamNewlineType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14155">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_byte" c:identifier="g_data_input_stream_read_byte" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14173">Reads an unsigned 8-bit/1-byte value from @stream.</doc>
|
|
<source-position filename="gdatainputstream.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14181">an unsigned 8-bit/1-byte value read from the @stream or `0`
|
|
if an error occurred.</doc>
|
|
<type name="guint8" c:type="guchar"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14175">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14176">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_int16" c:identifier="g_data_input_stream_read_int16" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14186">Reads a 16-bit/2-byte value from @stream.
|
|
|
|
In order to get the correct byte order for this read operation,
|
|
see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().</doc>
|
|
<source-position filename="gdatainputstream.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14197">a signed 16-bit/2-byte value read from @stream or `0` if
|
|
an error occurred.</doc>
|
|
<type name="gint16" c:type="gint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14188">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14189">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_int32" c:identifier="g_data_input_stream_read_int32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14202">Reads a signed 32-bit/4-byte value from @stream.
|
|
|
|
In order to get the correct byte order for this read operation,
|
|
see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gdatainputstream.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14217">a signed 32-bit/4-byte value read from the @stream or `0` if
|
|
an error occurred.</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14204">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14205">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_int64" c:identifier="g_data_input_stream_read_int64" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14222">Reads a 64-bit/8-byte value from @stream.
|
|
|
|
In order to get the correct byte order for this read operation,
|
|
see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gdatainputstream.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14237">a signed 64-bit/8-byte value read from @stream or `0` if
|
|
an error occurred.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14224">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14225">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_line" c:identifier="g_data_input_stream_read_line" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14242">Reads a line from the data input stream. Note that no encoding
|
|
checks or conversion is performed; the input is not guaranteed to
|
|
be UTF-8, and may in fact have embedded NUL characters.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gdatainputstream.h" line="113"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14257">
|
|
a NUL terminated byte array with the line that was read in
|
|
(without the newlines). Set @length to a #gsize to get the length
|
|
of the read line. On an error, it will return %NULL and @error
|
|
will be set. If there's no content to read, it will still return
|
|
%NULL, but @error won't be set.</doc>
|
|
<array c:type="char*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14244">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14245">a #gsize to get the length of the data read in.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14246">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_line_async" c:identifier="g_data_input_stream_read_line_async" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14266">The asynchronous version of g_data_input_stream_read_line(). It is
|
|
an error to have two outstanding calls to this function.
|
|
|
|
When the operation is finished, @callback will be called. You
|
|
can then call g_data_input_stream_read_line_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gdatainputstream.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14268">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14269">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14270">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14271">callback to call when the request is satisfied.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14272">the data to pass to callback function.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_line_finish" c:identifier="g_data_input_stream_read_line_finish" version="2.20" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14285">Finish an asynchronous call started by
|
|
g_data_input_stream_read_line_async(). Note the warning about
|
|
string encoding in g_data_input_stream_read_line() applies here as
|
|
well.</doc>
|
|
<source-position filename="gdatainputstream.h" line="129"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14297">
|
|
a NUL-terminated byte array with the line that was read in
|
|
(without the newlines). Set @length to a #gsize to get the length
|
|
of the read line. On an error, it will return %NULL and @error
|
|
will be set. If there's no content to read, it will still return
|
|
%NULL, but @error won't be set.</doc>
|
|
<array c:type="char*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14287">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14288">the #GAsyncResult that was provided to the callback.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14289">a #gsize to get the length of the data read in.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_line_finish_utf8" c:identifier="g_data_input_stream_read_line_finish_utf8" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14307">Finish an asynchronous call started by
|
|
g_data_input_stream_read_line_async().</doc>
|
|
<source-position filename="gdatainputstream.h" line="134"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14317">a string with the line that
|
|
was read in (without the newlines). Set @length to a #gsize to
|
|
get the length of the read line. On an error, it will return
|
|
%NULL and @error will be set. For UTF-8 conversion errors, the set
|
|
error domain is %G_CONVERT_ERROR. If there's no content to read,
|
|
it will still return %NULL, but @error won't be set.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14309">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14310">the #GAsyncResult that was provided to the callback.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14311">a #gsize to get the length of the data read in.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_line_utf8" c:identifier="g_data_input_stream_read_line_utf8" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14327">Reads a UTF-8 encoded line from the data input stream.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gdatainputstream.h" line="118"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14340">a NUL terminated UTF-8 string
|
|
with the line that was read in (without the newlines). Set
|
|
@length to a #gsize to get the length of the read line. On an
|
|
error, it will return %NULL and @error will be set. For UTF-8
|
|
conversion errors, the set error domain is %G_CONVERT_ERROR. If
|
|
there's no content to read, it will still return %NULL, but @error
|
|
won't be set.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14329">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14330">a #gsize to get the length of the data read in.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14331">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_uint16" c:identifier="g_data_input_stream_read_uint16" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14351">Reads an unsigned 16-bit/2-byte value from @stream.
|
|
|
|
In order to get the correct byte order for this read operation,
|
|
see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().</doc>
|
|
<source-position filename="gdatainputstream.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14362">an unsigned 16-bit/2-byte value read from the @stream or `0` if
|
|
an error occurred.</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14353">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14354">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_uint32" c:identifier="g_data_input_stream_read_uint32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14367">Reads an unsigned 32-bit/4-byte value from @stream.
|
|
|
|
In order to get the correct byte order for this read operation,
|
|
see g_data_input_stream_get_byte_order() and g_data_input_stream_set_byte_order().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gdatainputstream.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14382">an unsigned 32-bit/4-byte value read from the @stream or `0` if
|
|
an error occurred.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14369">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14370">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_uint64" c:identifier="g_data_input_stream_read_uint64" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14387">Reads an unsigned 64-bit/8-byte value from @stream.
|
|
|
|
In order to get the correct byte order for this read operation,
|
|
see g_data_input_stream_get_byte_order().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gdatainputstream.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14402">an unsigned 64-bit/8-byte read from @stream or `0` if
|
|
an error occurred.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14389">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14390">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_until" c:identifier="g_data_input_stream_read_until" deprecated="1" deprecated-version="2.56" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14407">Reads a string from the data input stream, up to the first
|
|
occurrence of any of the stop characters.
|
|
|
|
Note that, in contrast to g_data_input_stream_read_until_async(),
|
|
this function consumes the stop character that it finds.
|
|
|
|
Don't use this function in new code. Its functionality is
|
|
inconsistent with g_data_input_stream_read_until_async(). Both
|
|
functions will be marked as deprecated in a future release. Use
|
|
g_data_input_stream_read_upto() instead, but note that that function
|
|
does not consume the stop character.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto() instead, which has more
|
|
consistent behaviour regarding the stop character.</doc-deprecated>
|
|
<source-position filename="gdatainputstream.h" line="139"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14427">a string with the data that was read
|
|
before encountering any of the stop characters. Set @length to
|
|
a #gsize to get the length of the string. This function will
|
|
return %NULL on an error.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14409">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="stop_chars" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14410">characters to terminate the read.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14411">a #gsize to get the length of the data read in.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14412">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_until_async" c:identifier="g_data_input_stream_read_until_async" version="2.20" deprecated="1" deprecated-version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14436">The asynchronous version of g_data_input_stream_read_until().
|
|
It is an error to have two outstanding calls to this function.
|
|
|
|
Note that, in contrast to g_data_input_stream_read_until(),
|
|
this function does not consume the stop character that it finds. You
|
|
must read it for yourself.
|
|
|
|
When the operation is finished, @callback will be called. You
|
|
can then call g_data_input_stream_read_until_finish() to get
|
|
the result of the operation.
|
|
|
|
Don't use this function in new code. Its functionality is
|
|
inconsistent with g_data_input_stream_read_until(). Both functions
|
|
will be marked as deprecated in a future release. Use
|
|
g_data_input_stream_read_upto_async() instead.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto_async() instead, which
|
|
has more consistent behaviour regarding the stop character.</doc-deprecated>
|
|
<source-position filename="gdatainputstream.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14438">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="stop_chars" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14439">characters to terminate the read.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14440">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14441">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14442">callback to call when the request is satisfied.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14443">the data to pass to callback function.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_until_finish" c:identifier="g_data_input_stream_read_until_finish" version="2.20" deprecated="1" deprecated-version="2.56" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14467">Finish an asynchronous call started by
|
|
g_data_input_stream_read_until_async().</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_data_input_stream_read_upto_finish() instead, which
|
|
has more consistent behaviour regarding the stop character.</doc-deprecated>
|
|
<source-position filename="gdatainputstream.h" line="152"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14478">a string with the data that was read
|
|
before encountering any of the stop characters. Set @length to
|
|
a #gsize to get the length of the string. This function will
|
|
return %NULL on an error.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14469">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14470">the #GAsyncResult that was provided to the callback.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14471">a #gsize to get the length of the data read in.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_upto" c:identifier="g_data_input_stream_read_upto" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14487">Reads a string from the data input stream, up to the first
|
|
occurrence of any of the stop characters.
|
|
|
|
In contrast to g_data_input_stream_read_until(), this function
|
|
does not consume the stop character. You have to use
|
|
g_data_input_stream_read_byte() to get it before calling
|
|
g_data_input_stream_read_upto() again.
|
|
|
|
Note that @stop_chars may contain '\0' if @stop_chars_len is
|
|
specified.
|
|
|
|
The returned string will always be nul-terminated on success.</doc>
|
|
<source-position filename="gdatainputstream.h" line="158"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14510">a string with the data that was read
|
|
before encountering any of the stop characters. Set @length to
|
|
a #gsize to get the length of the string. This function will
|
|
return %NULL on an error</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14489">a #GDataInputStream</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="stop_chars" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14490">characters to terminate the read</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="stop_chars_len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14491">length of @stop_chars. May be -1 if @stop_chars is
|
|
nul-terminated</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14493">a #gsize to get the length of the data read in</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14494">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_upto_async" c:identifier="g_data_input_stream_read_upto_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14518">The asynchronous version of g_data_input_stream_read_upto().
|
|
It is an error to have two outstanding calls to this function.
|
|
|
|
In contrast to g_data_input_stream_read_until(), this function
|
|
does not consume the stop character. You have to use
|
|
g_data_input_stream_read_byte() to get it before calling
|
|
g_data_input_stream_read_upto() again.
|
|
|
|
Note that @stop_chars may contain '\0' if @stop_chars_len is
|
|
specified.
|
|
|
|
When the operation is finished, @callback will be called. You
|
|
can then call g_data_input_stream_read_upto_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gdatainputstream.h" line="165"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14520">a #GDataInputStream</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="stop_chars" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14521">characters to terminate the read</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="stop_chars_len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14522">length of @stop_chars. May be -1 if @stop_chars is
|
|
nul-terminated</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14524">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14525">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14526">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14527">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_upto_finish" c:identifier="g_data_input_stream_read_upto_finish" version="2.24" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14548">Finish an asynchronous call started by
|
|
g_data_input_stream_read_upto_async().
|
|
|
|
Note that this function does not consume the stop character. You
|
|
have to use g_data_input_stream_read_byte() to get it before calling
|
|
g_data_input_stream_read_upto_async() again.
|
|
|
|
The returned string will always be nul-terminated on success.</doc>
|
|
<source-position filename="gdatainputstream.h" line="173"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14564">a string with the data that was read
|
|
before encountering any of the stop characters. Set @length to
|
|
a #gsize to get the length of the string. This function will
|
|
return %NULL on an error.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14550">a #GDataInputStream</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14551">the #GAsyncResult that was provided to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14552">a #gsize to get the length of the data read in</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_byte_order" c:identifier="g_data_input_stream_set_byte_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14572">This function sets the byte order for the given @stream. All subsequent
|
|
reads from the @stream will be read in the given @order.</doc>
|
|
<source-position filename="gdatainputstream.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14574">a given #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="order" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14575">a #GDataStreamByteOrder to set.</doc>
|
|
<type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_newline_type" c:identifier="g_data_input_stream_set_newline_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14582">Sets the newline type for the @stream.
|
|
|
|
Note that using G_DATA_STREAM_NEWLINE_TYPE_ANY is slightly unsafe. If a read
|
|
chunk ends in "CR" we must read an additional byte to know if this is "CR" or
|
|
"CR LF", and this might block if there is no more data available.</doc>
|
|
<source-position filename="gdatainputstream.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14584">a #GDataInputStream.</doc>
|
|
<type name="DataInputStream" c:type="GDataInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14585">the type of new line return as #GDataStreamNewlineType.</doc>
|
|
<type name="DataStreamNewlineType" c:type="GDataStreamNewlineType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="byte-order" writable="1" transfer-ownership="none">
|
|
<type name="DataStreamByteOrder"/>
|
|
</property>
|
|
<property name="newline-type" writable="1" transfer-ownership="none">
|
|
<type name="DataStreamNewlineType"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="BufferedInputStream" c:type="GBufferedInputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DataInputStreamPrivate" c:type="GDataInputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="DataInputStreamClass" c:type="GDataInputStreamClass" glib:is-gtype-struct-for="DataInputStream">
|
|
<source-position filename="gdatainputstream.h" line="67"/>
|
|
<field name="parent_class">
|
|
<type name="BufferedInputStreamClass" c:type="GBufferedInputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gdatainputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gdatainputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gdatainputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gdatainputstream.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gdatainputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="DataInputStreamPrivate" c:type="GDataInputStreamPrivate" disguised="1">
|
|
<source-position filename="gdatainputstream.h" line="46"/>
|
|
</record>
|
|
<class name="DataOutputStream" c:symbol-prefix="data_output_stream" c:type="GDataOutputStream" parent="FilterOutputStream" glib:type-name="GDataOutputStream" glib:get-type="g_data_output_stream_get_type" glib:type-struct="DataOutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5415">Data output stream implements #GOutputStream and includes functions for
|
|
writing data directly to an output stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="68"/>
|
|
<implements name="Seekable"/>
|
|
<constructor name="new" c:identifier="g_data_output_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14605">Creates a new data output stream for @base_stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14611">#GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14607">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_byte_order" c:identifier="g_data_output_stream_get_byte_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14595">Gets the byte order for the stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14601">the #GDataStreamByteOrder for the @stream.</doc>
|
|
<type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14597">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_byte" c:identifier="g_data_output_stream_put_byte" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14615">Puts a byte into the output stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14624">%TRUE if @data was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14617">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14618">a #guchar.</doc>
|
|
<type name="guint8" c:type="guchar"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14619">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int16" c:identifier="g_data_output_stream_put_int16" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14628">Puts a signed 16-bit integer into the output stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14637">%TRUE if @data was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14630">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14631">a #gint16.</doc>
|
|
<type name="gint16" c:type="gint16"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14632">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int32" c:identifier="g_data_output_stream_put_int32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14641">Puts a signed 32-bit integer into the output stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14650">%TRUE if @data was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14643">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14644">a #gint32.</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14645">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_int64" c:identifier="g_data_output_stream_put_int64" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14654">Puts a signed 64-bit integer into the stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14663">%TRUE if @data was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14656">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14657">a #gint64.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14658">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_string" c:identifier="g_data_output_stream_put_string" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14667">Puts a string into the output stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14676">%TRUE if @string was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14669">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="str" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14670">a string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14671">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint16" c:identifier="g_data_output_stream_put_uint16" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14680">Puts an unsigned 16-bit integer into the output stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14689">%TRUE if @data was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14682">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14683">a #guint16.</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14684">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint32" c:identifier="g_data_output_stream_put_uint32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14693">Puts an unsigned 32-bit integer into the stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14702">%TRUE if @data was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14695">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14696">a #guint32.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14697">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="put_uint64" c:identifier="g_data_output_stream_put_uint64" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14706">Puts an unsigned 64-bit integer into the stream.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14715">%TRUE if @data was successfully added to the @stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14708">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14709">a #guint64.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14710">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_byte_order" c:identifier="g_data_output_stream_set_byte_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14719">Sets the byte order of the data output stream to @order.</doc>
|
|
<source-position filename="gdataoutputstream.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14721">a #GDataOutputStream.</doc>
|
|
<type name="DataOutputStream" c:type="GDataOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="order" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14722">a %GDataStreamByteOrder.</doc>
|
|
<type name="DataStreamByteOrder" c:type="GDataStreamByteOrder"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="byte-order" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1445">Determines the byte ordering that is used when writing
|
|
multi-byte entities (such as integers) to the stream.</doc>
|
|
<type name="DataStreamByteOrder"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="FilterOutputStream" c:type="GFilterOutputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="DataOutputStreamPrivate" c:type="GDataOutputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="DataOutputStreamClass" c:type="GDataOutputStreamClass" glib:is-gtype-struct-for="DataOutputStream">
|
|
<source-position filename="gdataoutputstream.h" line="68"/>
|
|
<field name="parent_class">
|
|
<type name="FilterOutputStreamClass" c:type="GFilterOutputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gdataoutputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gdataoutputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gdataoutputstream.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gdataoutputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gdataoutputstream.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="DataOutputStreamPrivate" c:type="GDataOutputStreamPrivate" disguised="1">
|
|
<source-position filename="gdataoutputstream.h" line="47"/>
|
|
</record>
|
|
<enumeration name="DataStreamByteOrder" glib:type-name="GDataStreamByteOrder" glib:get-type="g_data_stream_byte_order_get_type" c:type="GDataStreamByteOrder">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="84">#GDataStreamByteOrder is used to ensure proper endianness of streaming data sources
|
|
across various machine architectures.</doc>
|
|
<member name="big_endian" value="0" c:identifier="G_DATA_STREAM_BYTE_ORDER_BIG_ENDIAN" glib:nick="big-endian">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="86">Selects Big Endian byte order.</doc>
|
|
</member>
|
|
<member name="little_endian" value="1" c:identifier="G_DATA_STREAM_BYTE_ORDER_LITTLE_ENDIAN" glib:nick="little-endian">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="87">Selects Little Endian byte order.</doc>
|
|
</member>
|
|
<member name="host_endian" value="2" c:identifier="G_DATA_STREAM_BYTE_ORDER_HOST_ENDIAN" glib:nick="host-endian">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="88">Selects endianness based on host machine's architecture.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<enumeration name="DataStreamNewlineType" glib:type-name="GDataStreamNewlineType" glib:get-type="g_data_stream_newline_type_get_type" c:type="GDataStreamNewlineType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="101">#GDataStreamNewlineType is used when checking for or setting the line endings for a given file.</doc>
|
|
<member name="lf" value="0" c:identifier="G_DATA_STREAM_NEWLINE_TYPE_LF" glib:nick="lf">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="103">Selects "LF" line endings, common on most modern UNIX platforms.</doc>
|
|
</member>
|
|
<member name="cr" value="1" c:identifier="G_DATA_STREAM_NEWLINE_TYPE_CR" glib:nick="cr">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="104">Selects "CR" line endings.</doc>
|
|
</member>
|
|
<member name="cr_lf" value="2" c:identifier="G_DATA_STREAM_NEWLINE_TYPE_CR_LF" glib:nick="cr-lf">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="105">Selects "CR, LF" line ending, common on Microsoft Windows.</doc>
|
|
</member>
|
|
<member name="any" value="3" c:identifier="G_DATA_STREAM_NEWLINE_TYPE_ANY" glib:nick="any">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="106">Automatically try to handle any line ending type.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<interface name="DatagramBased" c:symbol-prefix="datagram_based" c:type="GDatagramBased" version="2.48" glib:type-name="GDatagramBased" glib:get-type="g_datagram_based_get_type" glib:type-struct="DatagramBasedInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="5346">A #GDatagramBased is a networking interface for representing datagram-based
|
|
communications. It is a more or less direct mapping of the core parts of the
|
|
BSD socket API in a portable GObject interface. It is implemented by
|
|
#GSocket, which wraps the UNIX socket API on UNIX and winsock2 on Windows.
|
|
|
|
#GDatagramBased is entirely platform independent, and is intended to be used
|
|
alongside higher-level networking APIs such as #GIOStream.
|
|
|
|
It uses vectored scatter/gather I/O by default, allowing for many messages
|
|
to be sent or received in a single call. Where possible, implementations of
|
|
the interface should take advantage of vectored I/O to minimise processing
|
|
or system calls. For example, #GSocket uses recvmmsg() and sendmmsg() where
|
|
possible. Callers should take advantage of scatter/gather I/O (the use of
|
|
multiple buffers per message) to avoid unnecessary copying of data to
|
|
assemble or disassemble a message.
|
|
|
|
Each #GDatagramBased operation has a timeout parameter which may be negative
|
|
for blocking behaviour, zero for non-blocking behaviour, or positive for
|
|
timeout behaviour. A blocking operation blocks until finished or there is an
|
|
error. A non-blocking operation will return immediately with a
|
|
%G_IO_ERROR_WOULD_BLOCK error if it cannot make progress. A timeout operation
|
|
will block until the operation is complete or the timeout expires; if the
|
|
timeout expires it will return what progress it made, or
|
|
%G_IO_ERROR_TIMED_OUT if no progress was made. To know when a call would
|
|
successfully run you can call g_datagram_based_condition_check() or
|
|
g_datagram_based_condition_wait(). You can also use
|
|
g_datagram_based_create_source() and attach it to a #GMainContext to get
|
|
callbacks when I/O is possible.
|
|
|
|
When running a non-blocking operation applications should always be able to
|
|
handle getting a %G_IO_ERROR_WOULD_BLOCK error even when some other function
|
|
said that I/O was possible. This can easily happen in case of a race
|
|
condition in the application, but it can also happen for other reasons. For
|
|
instance, on Windows a socket is always seen as writable until a write
|
|
returns %G_IO_ERROR_WOULD_BLOCK.
|
|
|
|
As with #GSocket, #GDatagramBaseds can be either connection oriented (for
|
|
example, SCTP) or connectionless (for example, UDP). #GDatagramBaseds must be
|
|
datagram-based, not stream-based. The interface does not cover connection
|
|
establishment — use methods on the underlying type to establish a connection
|
|
before sending and receiving data through the #GDatagramBased API. For
|
|
connectionless socket types the target/source address is specified or
|
|
received in each I/O operation.
|
|
|
|
Like most other APIs in GLib, #GDatagramBased is not inherently thread safe.
|
|
To use a #GDatagramBased concurrently from multiple threads, you must
|
|
implement your own locking.</doc>
|
|
<source-position filename="gdatagrambased.h" line="99"/>
|
|
<virtual-method name="condition_check" invoker="condition_check" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14728">Checks on the readiness of @datagram_based to perform operations. The
|
|
operations specified in @condition are checked for and masked against the
|
|
currently-satisfied conditions on @datagram_based. The result is returned.
|
|
|
|
%G_IO_IN will be set in the return value if data is available to read with
|
|
g_datagram_based_receive_messages(), or if the connection is closed remotely
|
|
(EOS); and if the datagram_based has not been closed locally using some
|
|
implementation-specific method (such as g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket).
|
|
|
|
If the connection is shut down or closed (by calling g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket, for
|
|
example), all calls to this function will return %G_IO_ERROR_CLOSED.
|
|
|
|
%G_IO_OUT will be set if it is expected that at least one byte can be sent
|
|
using g_datagram_based_send_messages() without blocking. It will not be set
|
|
if the datagram_based has been closed locally.
|
|
|
|
%G_IO_HUP will be set if the connection has been closed locally.
|
|
|
|
%G_IO_ERR will be set if there was an asynchronous error in transmitting data
|
|
previously enqueued using g_datagram_based_send_messages().
|
|
|
|
Note that on Windows, it is possible for an operation to return
|
|
%G_IO_ERROR_WOULD_BLOCK even immediately after
|
|
g_datagram_based_condition_check() has claimed that the #GDatagramBased is
|
|
ready for writing. Rather than calling g_datagram_based_condition_check() and
|
|
then writing to the #GDatagramBased if it succeeds, it is generally better to
|
|
simply try writing right away, and try again later if the initial attempt
|
|
returns %G_IO_ERROR_WOULD_BLOCK.
|
|
|
|
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition; these
|
|
conditions will always be set in the output if they are true. Apart from
|
|
these flags, the output is guaranteed to be masked by @condition.
|
|
|
|
This call never blocks.</doc>
|
|
<source-position filename="gdatagrambased.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14770">the #GIOCondition mask of the current state</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14730">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14731">a #GIOCondition mask to check</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="condition_wait" invoker="condition_wait" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14775">Waits for up to @timeout microseconds for condition to become true on
|
|
@datagram_based. If the condition is met, %TRUE is returned.
|
|
|
|
If @cancellable is cancelled before the condition is met, or if @timeout is
|
|
reached before the condition is met, then %FALSE is returned and @error is
|
|
set appropriately (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT).</doc>
|
|
<source-position filename="gdatagrambased.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14791">%TRUE if the condition was met, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14777">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14778">a #GIOCondition mask to wait for</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14779">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14781">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_source" invoker="create_source" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14796">Creates a #GSource that can be attached to a #GMainContext to monitor for
|
|
the availability of the specified @condition on the #GDatagramBased. The
|
|
#GSource keeps a reference to the @datagram_based.
|
|
|
|
The callback on the source is of the #GDatagramBasedSourceFunc type.
|
|
|
|
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition; these
|
|
conditions will always be reported in the callback if they are true.
|
|
|
|
If non-%NULL, @cancellable can be used to cancel the source, which will
|
|
cause the source to trigger, reporting the current condition (which is
|
|
likely 0 unless cancellation happened at the same time as a condition
|
|
change). You can check for this in the callback using
|
|
g_cancellable_is_cancelled().</doc>
|
|
<source-position filename="gdatagrambased.h" line="89"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14817">a newly allocated #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14798">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14799">a #GIOCondition mask to monitor</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14800">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="receive_messages" invoker="receive_messages" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14822">Receive one or more data messages from @datagram_based in one go.
|
|
|
|
@messages must point to an array of #GInputMessage structs and
|
|
@num_messages must be the length of this array. Each #GInputMessage
|
|
contains a pointer to an array of #GInputVector structs describing the
|
|
buffers that the data received in each message will be written to.
|
|
|
|
@flags modify how all messages are received. The commonly available
|
|
arguments for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too. These
|
|
flags affect the overall receive operation. Flags affecting individual
|
|
messages are returned in #GInputMessage.flags.
|
|
|
|
The other members of #GInputMessage are treated as described in its
|
|
documentation.
|
|
|
|
If @timeout is negative the call will block until @num_messages have been
|
|
received, the connection is closed remotely (EOS), @cancellable is cancelled,
|
|
or an error occurs.
|
|
|
|
If @timeout is 0 the call will return up to @num_messages without blocking,
|
|
or %G_IO_ERROR_WOULD_BLOCK if no messages are queued in the operating system
|
|
to be received.
|
|
|
|
If @timeout is positive the call will block on the same conditions as if
|
|
@timeout were negative. If the timeout is reached
|
|
before any messages are received, %G_IO_ERROR_TIMED_OUT is returned,
|
|
otherwise it will return the number of messages received before timing out.
|
|
(Note: This is effectively the behaviour of `MSG_WAITFORONE` with
|
|
recvmmsg().)
|
|
|
|
To be notified when messages are available, wait for the %G_IO_IN condition.
|
|
Note though that you may still receive %G_IO_ERROR_WOULD_BLOCK from
|
|
g_datagram_based_receive_messages() even if you were previously notified of a
|
|
%G_IO_IN condition.
|
|
|
|
If the remote peer closes the connection, any messages queued in the
|
|
underlying receive buffer will be returned, and subsequent calls to
|
|
g_datagram_based_receive_messages() will return 0 (with no error set).
|
|
|
|
If the connection is shut down or closed (by calling g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket, for
|
|
example), all calls to this function will return %G_IO_ERROR_CLOSED.
|
|
|
|
On error -1 is returned and @error is set accordingly. An error will only
|
|
be returned if zero messages could be received; otherwise the number of
|
|
messages successfully received before the error will be returned. If
|
|
@cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any
|
|
other error.</doc>
|
|
<source-position filename="gdatagrambased.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14884">number of messages received, or -1 on error. Note that the number
|
|
of messages received may be smaller than @num_messages if @timeout is
|
|
zero or positive, if the peer closed the connection, or if @num_messages
|
|
was larger than `UIO_MAXIOV` (1024), in which case the caller may re-try
|
|
to receive the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14824">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14825">an array of #GInputMessage structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="GInputMessage*">
|
|
<type name="InputMessage" c:type="GInputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14826">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14827">an int containing #GSocketMsgFlags flags for the overall operation</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14828">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14830">a %GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="send_messages" invoker="send_messages" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14893">Send one or more data messages from @datagram_based in one go.
|
|
|
|
@messages must point to an array of #GOutputMessage structs and
|
|
@num_messages must be the length of this array. Each #GOutputMessage
|
|
contains an address to send the data to, and a pointer to an array of
|
|
#GOutputVector structs to describe the buffers that the data to be sent
|
|
for each message will be gathered from.
|
|
|
|
@flags modify how the message is sent. The commonly available arguments
|
|
for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too.
|
|
|
|
The other members of #GOutputMessage are treated as described in its
|
|
documentation.
|
|
|
|
If @timeout is negative the call will block until @num_messages have been
|
|
sent, @cancellable is cancelled, or an error occurs.
|
|
|
|
If @timeout is 0 the call will send up to @num_messages without blocking,
|
|
or will return %G_IO_ERROR_WOULD_BLOCK if there is no space to send messages.
|
|
|
|
If @timeout is positive the call will block on the same conditions as if
|
|
@timeout were negative. If the timeout is reached before any messages are
|
|
sent, %G_IO_ERROR_TIMED_OUT is returned, otherwise it will return the number
|
|
of messages sent before timing out.
|
|
|
|
To be notified when messages can be sent, wait for the %G_IO_OUT condition.
|
|
Note though that you may still receive %G_IO_ERROR_WOULD_BLOCK from
|
|
g_datagram_based_send_messages() even if you were previously notified of a
|
|
%G_IO_OUT condition. (On Windows in particular, this is very common due to
|
|
the way the underlying APIs work.)
|
|
|
|
If the connection is shut down or closed (by calling g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_write set, if it’s a #GSocket, for
|
|
example), all calls to this function will return %G_IO_ERROR_CLOSED.
|
|
|
|
On error -1 is returned and @error is set accordingly. An error will only
|
|
be returned if zero messages could be sent; otherwise the number of messages
|
|
successfully sent before the error will be returned. If @cancellable is
|
|
cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error.</doc>
|
|
<source-position filename="gdatagrambased.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14946">number of messages sent, or -1 on error. Note that the number of
|
|
messages sent may be smaller than @num_messages if @timeout is zero
|
|
or positive, or if @num_messages was larger than `UIO_MAXIOV` (1024), in
|
|
which case the caller may re-try to send the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14895">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14896">an array of #GOutputMessage structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="GOutputMessage*">
|
|
<type name="OutputMessage" c:type="GOutputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14897">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14898">an int containing #GSocketMsgFlags flags</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14899">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14901">a %GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="condition_check" c:identifier="g_datagram_based_condition_check" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14728">Checks on the readiness of @datagram_based to perform operations. The
|
|
operations specified in @condition are checked for and masked against the
|
|
currently-satisfied conditions on @datagram_based. The result is returned.
|
|
|
|
%G_IO_IN will be set in the return value if data is available to read with
|
|
g_datagram_based_receive_messages(), or if the connection is closed remotely
|
|
(EOS); and if the datagram_based has not been closed locally using some
|
|
implementation-specific method (such as g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket).
|
|
|
|
If the connection is shut down or closed (by calling g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket, for
|
|
example), all calls to this function will return %G_IO_ERROR_CLOSED.
|
|
|
|
%G_IO_OUT will be set if it is expected that at least one byte can be sent
|
|
using g_datagram_based_send_messages() without blocking. It will not be set
|
|
if the datagram_based has been closed locally.
|
|
|
|
%G_IO_HUP will be set if the connection has been closed locally.
|
|
|
|
%G_IO_ERR will be set if there was an asynchronous error in transmitting data
|
|
previously enqueued using g_datagram_based_send_messages().
|
|
|
|
Note that on Windows, it is possible for an operation to return
|
|
%G_IO_ERROR_WOULD_BLOCK even immediately after
|
|
g_datagram_based_condition_check() has claimed that the #GDatagramBased is
|
|
ready for writing. Rather than calling g_datagram_based_condition_check() and
|
|
then writing to the #GDatagramBased if it succeeds, it is generally better to
|
|
simply try writing right away, and try again later if the initial attempt
|
|
returns %G_IO_ERROR_WOULD_BLOCK.
|
|
|
|
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition; these
|
|
conditions will always be set in the output if they are true. Apart from
|
|
these flags, the output is guaranteed to be masked by @condition.
|
|
|
|
This call never blocks.</doc>
|
|
<source-position filename="gdatagrambased.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14770">the #GIOCondition mask of the current state</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14730">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14731">a #GIOCondition mask to check</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="condition_wait" c:identifier="g_datagram_based_condition_wait" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14775">Waits for up to @timeout microseconds for condition to become true on
|
|
@datagram_based. If the condition is met, %TRUE is returned.
|
|
|
|
If @cancellable is cancelled before the condition is met, or if @timeout is
|
|
reached before the condition is met, then %FALSE is returned and @error is
|
|
set appropriately (%G_IO_ERROR_CANCELLED or %G_IO_ERROR_TIMED_OUT).</doc>
|
|
<source-position filename="gdatagrambased.h" line="136"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14791">%TRUE if the condition was met, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14777">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14778">a #GIOCondition mask to wait for</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14779">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14781">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_source" c:identifier="g_datagram_based_create_source" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14796">Creates a #GSource that can be attached to a #GMainContext to monitor for
|
|
the availability of the specified @condition on the #GDatagramBased. The
|
|
#GSource keeps a reference to the @datagram_based.
|
|
|
|
The callback on the source is of the #GDatagramBasedSourceFunc type.
|
|
|
|
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition; these
|
|
conditions will always be reported in the callback if they are true.
|
|
|
|
If non-%NULL, @cancellable can be used to cancel the source, which will
|
|
cause the source to trigger, reporting the current condition (which is
|
|
likely 0 unless cancellation happened at the same time as a condition
|
|
change). You can check for this in the callback using
|
|
g_cancellable_is_cancelled().</doc>
|
|
<source-position filename="gdatagrambased.h" line="127"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14817">a newly allocated #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14798">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14799">a #GIOCondition mask to monitor</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14800">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_messages" c:identifier="g_datagram_based_receive_messages" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14822">Receive one or more data messages from @datagram_based in one go.
|
|
|
|
@messages must point to an array of #GInputMessage structs and
|
|
@num_messages must be the length of this array. Each #GInputMessage
|
|
contains a pointer to an array of #GInputVector structs describing the
|
|
buffers that the data received in each message will be written to.
|
|
|
|
@flags modify how all messages are received. The commonly available
|
|
arguments for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too. These
|
|
flags affect the overall receive operation. Flags affecting individual
|
|
messages are returned in #GInputMessage.flags.
|
|
|
|
The other members of #GInputMessage are treated as described in its
|
|
documentation.
|
|
|
|
If @timeout is negative the call will block until @num_messages have been
|
|
received, the connection is closed remotely (EOS), @cancellable is cancelled,
|
|
or an error occurs.
|
|
|
|
If @timeout is 0 the call will return up to @num_messages without blocking,
|
|
or %G_IO_ERROR_WOULD_BLOCK if no messages are queued in the operating system
|
|
to be received.
|
|
|
|
If @timeout is positive the call will block on the same conditions as if
|
|
@timeout were negative. If the timeout is reached
|
|
before any messages are received, %G_IO_ERROR_TIMED_OUT is returned,
|
|
otherwise it will return the number of messages received before timing out.
|
|
(Note: This is effectively the behaviour of `MSG_WAITFORONE` with
|
|
recvmmsg().)
|
|
|
|
To be notified when messages are available, wait for the %G_IO_IN condition.
|
|
Note though that you may still receive %G_IO_ERROR_WOULD_BLOCK from
|
|
g_datagram_based_receive_messages() even if you were previously notified of a
|
|
%G_IO_IN condition.
|
|
|
|
If the remote peer closes the connection, any messages queued in the
|
|
underlying receive buffer will be returned, and subsequent calls to
|
|
g_datagram_based_receive_messages() will return 0 (with no error set).
|
|
|
|
If the connection is shut down or closed (by calling g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_read set, if it’s a #GSocket, for
|
|
example), all calls to this function will return %G_IO_ERROR_CLOSED.
|
|
|
|
On error -1 is returned and @error is set accordingly. An error will only
|
|
be returned if zero messages could be received; otherwise the number of
|
|
messages successfully received before the error will be returned. If
|
|
@cancellable is cancelled, %G_IO_ERROR_CANCELLED is returned as with any
|
|
other error.</doc>
|
|
<source-position filename="gdatagrambased.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14884">number of messages received, or -1 on error. Note that the number
|
|
of messages received may be smaller than @num_messages if @timeout is
|
|
zero or positive, if the peer closed the connection, or if @num_messages
|
|
was larger than `UIO_MAXIOV` (1024), in which case the caller may re-try
|
|
to receive the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14824">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14825">an array of #GInputMessage structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="GInputMessage*">
|
|
<type name="InputMessage" c:type="GInputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14826">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14827">an int containing #GSocketMsgFlags flags for the overall operation</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14828">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14830">a %GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_messages" c:identifier="g_datagram_based_send_messages" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14893">Send one or more data messages from @datagram_based in one go.
|
|
|
|
@messages must point to an array of #GOutputMessage structs and
|
|
@num_messages must be the length of this array. Each #GOutputMessage
|
|
contains an address to send the data to, and a pointer to an array of
|
|
#GOutputVector structs to describe the buffers that the data to be sent
|
|
for each message will be gathered from.
|
|
|
|
@flags modify how the message is sent. The commonly available arguments
|
|
for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too.
|
|
|
|
The other members of #GOutputMessage are treated as described in its
|
|
documentation.
|
|
|
|
If @timeout is negative the call will block until @num_messages have been
|
|
sent, @cancellable is cancelled, or an error occurs.
|
|
|
|
If @timeout is 0 the call will send up to @num_messages without blocking,
|
|
or will return %G_IO_ERROR_WOULD_BLOCK if there is no space to send messages.
|
|
|
|
If @timeout is positive the call will block on the same conditions as if
|
|
@timeout were negative. If the timeout is reached before any messages are
|
|
sent, %G_IO_ERROR_TIMED_OUT is returned, otherwise it will return the number
|
|
of messages sent before timing out.
|
|
|
|
To be notified when messages can be sent, wait for the %G_IO_OUT condition.
|
|
Note though that you may still receive %G_IO_ERROR_WOULD_BLOCK from
|
|
g_datagram_based_send_messages() even if you were previously notified of a
|
|
%G_IO_OUT condition. (On Windows in particular, this is very common due to
|
|
the way the underlying APIs work.)
|
|
|
|
If the connection is shut down or closed (by calling g_socket_close() or
|
|
g_socket_shutdown() with @shutdown_write set, if it’s a #GSocket, for
|
|
example), all calls to this function will return %G_IO_ERROR_CLOSED.
|
|
|
|
On error -1 is returned and @error is set accordingly. An error will only
|
|
be returned if zero messages could be sent; otherwise the number of messages
|
|
successfully sent before the error will be returned. If @cancellable is
|
|
cancelled, %G_IO_ERROR_CANCELLED is returned as with any other error.</doc>
|
|
<source-position filename="gdatagrambased.h" line="117"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14946">number of messages sent, or -1 on error. Note that the number of
|
|
messages sent may be smaller than @num_messages if @timeout is zero
|
|
or positive, or if @num_messages was larger than `UIO_MAXIOV` (1024), in
|
|
which case the caller may re-try to send the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14895">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</instance-parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14896">an array of #GOutputMessage structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="GOutputMessage*">
|
|
<type name="OutputMessage" c:type="GOutputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14897">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14898">an int containing #GSocketMsgFlags flags</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14899">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14901">a %GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="DatagramBasedInterface" c:type="GDatagramBasedInterface" glib:is-gtype-struct-for="DatagramBased" version="2.48">
|
|
<doc xml:space="preserve" filename="gdatagrambased.h" line="51">Provides an interface for socket-like objects which have datagram semantics,
|
|
following the Berkeley sockets API. The interface methods are thin wrappers
|
|
around the corresponding virtual methods, and no pre-processing of inputs is
|
|
implemented — so implementations of this API must handle all functionality
|
|
documented in the interface methods.</doc>
|
|
<source-position filename="gdatagrambased.h" line="99"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gdatagrambased.h" line="53">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="receive_messages">
|
|
<callback name="receive_messages" throws="1">
|
|
<source-position filename="gdatagrambased.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14884">number of messages received, or -1 on error. Note that the number
|
|
of messages received may be smaller than @num_messages if @timeout is
|
|
zero or positive, if the peer closed the connection, or if @num_messages
|
|
was larger than `UIO_MAXIOV` (1024), in which case the caller may re-try
|
|
to receive the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14824">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14825">an array of #GInputMessage structs</doc>
|
|
<array length="2" zero-terminated="0" c:type="GInputMessage*">
|
|
<type name="InputMessage" c:type="GInputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14826">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14827">an int containing #GSocketMsgFlags flags for the overall operation</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14828">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14830">a %GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="send_messages">
|
|
<callback name="send_messages" throws="1">
|
|
<source-position filename="gdatagrambased.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14946">number of messages sent, or -1 on error. Note that the number of
|
|
messages sent may be smaller than @num_messages if @timeout is zero
|
|
or positive, or if @num_messages was larger than `UIO_MAXIOV` (1024), in
|
|
which case the caller may re-try to send the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14895">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14896">an array of #GOutputMessage structs</doc>
|
|
<array length="2" zero-terminated="0" c:type="GOutputMessage*">
|
|
<type name="OutputMessage" c:type="GOutputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14897">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14898">an int containing #GSocketMsgFlags flags</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14899">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14901">a %GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_source">
|
|
<callback name="create_source">
|
|
<source-position filename="gdatagrambased.h" line="89"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14817">a newly allocated #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14798">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14799">a #GIOCondition mask to monitor</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14800">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="condition_check">
|
|
<callback name="condition_check">
|
|
<source-position filename="gdatagrambased.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14770">the #GIOCondition mask of the current state</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14730">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14731">a #GIOCondition mask to check</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="condition_wait">
|
|
<callback name="condition_wait" throws="1">
|
|
<source-position filename="gdatagrambased.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14791">%TRUE if the condition was met, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14777">a #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14778">a #GIOCondition mask to wait for</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14779">the maximum time (in microseconds) to wait, 0 to not block, or -1
|
|
to block indefinitely</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14781">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<callback name="DatagramBasedSourceFunc" c:type="GDatagramBasedSourceFunc" version="2.48">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="402">This is the function type of the callback used for the #GSource
|
|
returned by g_datagram_based_create_source().</doc>
|
|
<source-position filename="giotypes.h" line="416"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="411">%G_SOURCE_REMOVE if the source should be removed,
|
|
%G_SOURCE_CONTINUE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="datagram_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="404">the #GDatagramBased</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="405">the current condition at the source fired</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="406">data passed in by the user</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="DesktopAppInfo" c:symbol-prefix="desktop_app_info" c:type="GDesktopAppInfo" parent="GObject.Object" glib:type-name="GDesktopAppInfo" glib:get-type="g_desktop_app_info_get_type" glib:type-struct="DesktopAppInfoClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6002">#GDesktopAppInfo is an implementation of #GAppInfo based on
|
|
desktop files.
|
|
|
|
Note that `<gio/gdesktopappinfo.h>` belongs to the UNIX-specific
|
|
GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config
|
|
file when using it.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="43"/>
|
|
<implements name="AppInfo"/>
|
|
<constructor name="new" c:identifier="g_desktop_app_info_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19662">Creates a new #GDesktopAppInfo based on a desktop file id.
|
|
|
|
A desktop file id is the basename of the desktop file, including the
|
|
.desktop extension. GIO is looking for a desktop file with this name
|
|
in the `applications` subdirectories of the XDG
|
|
data directories (i.e. the directories specified in the `XDG_DATA_HOME`
|
|
and `XDG_DATA_DIRS` environment variables). GIO also supports the
|
|
prefix-to-subdirectory mapping that is described in the
|
|
[Menu Spec](http://standards.freedesktop.org/menu-spec/latest/)
|
|
(i.e. a desktop id of kde-foo.desktop will match
|
|
`/usr/share/applications/kde/foo.desktop`).</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="72"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19678">a new #GDesktopAppInfo, or %NULL if no desktop
|
|
file with that id exists.</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="desktop_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19664">the desktop file id</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_filename" c:identifier="g_desktop_app_info_new_from_filename">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19683">Creates a new #GDesktopAppInfo.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="50"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19690">a new #GDesktopAppInfo or %NULL on error.</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19685">the path of a desktop file, in the GLib
|
|
filename encoding</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_keyfile" c:identifier="g_desktop_app_info_new_from_keyfile" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19694">Creates a new #GDesktopAppInfo.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="52"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19700">a new #GDesktopAppInfo or %NULL on error.</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="key_file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19696">an opened #GKeyFile</doc>
|
|
<type name="GLib.KeyFile" c:type="GKeyFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="get_implementations" c:identifier="g_desktop_app_info_get_implementations" version="2.42">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19390">Gets all applications that implement @interface.
|
|
|
|
An application implements an interface if that interface is listed in
|
|
the Implements= line of the desktop file of the application.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="194"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19399">a list of #GDesktopAppInfo
|
|
objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="DesktopAppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interface" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19392">the name of the interface</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="search" c:identifier="g_desktop_app_info_search">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19705">Searches desktop files for ones that match @search_string.
|
|
|
|
The return value is an array of strvs. Each strv contains a list of
|
|
applications that matched @search_string with an equal score. The
|
|
outer list is sorted by score so that the first strv contains the
|
|
best-matching applications, and so on.
|
|
The algorithm for determining matches is undefined and may change at
|
|
any time.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="191"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19718">a
|
|
list of strvs. Free each item with g_strfreev() and free the outer
|
|
list with g_free().</doc>
|
|
<array c:type="gchar***">
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="search_string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19707">the search string to use</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="set_desktop_env" c:identifier="g_desktop_app_info_set_desktop_env" deprecated="1" deprecated-version="2.42">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19724">Sets the name of the desktop that the application is running in.
|
|
This is used by g_app_info_should_show() and
|
|
g_desktop_app_info_get_show_in() to evaluate the
|
|
`OnlyShowIn` and `NotShowIn`
|
|
desktop entry fields.
|
|
|
|
Should be called only once; subsequent calls are ignored.</doc>
|
|
<doc-deprecated xml:space="preserve">do not use this API. Since 2.42 the value of the
|
|
`XDG_CURRENT_DESKTOP` environment variable will be used.</doc-deprecated>
|
|
<source-position filename="gdesktopappinfo.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="desktop_env" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19726">a string specifying what desktop this is</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="get_action_name" c:identifier="g_desktop_app_info_get_action_name" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19323">Gets the user-visible display name of the "additional application
|
|
action" specified by @action_name.
|
|
|
|
This corresponds to the "Name" key within the keyfile group for the
|
|
action.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="106"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19335">the locale-specific action name</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19325">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19326">the name of the action as from
|
|
g_desktop_app_info_list_actions()</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_boolean" c:identifier="g_desktop_app_info_get_boolean" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19340">Looks up a boolean value in the keyfile backing @info.
|
|
|
|
The @key is looked up in the "Desktop Entry" group.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19349">the boolean value, or %FALSE if the key
|
|
is not found</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19342">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19343">the key to look up</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_categories" c:identifier="g_desktop_app_info_get_categories">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19355">Gets the categories from the desktop file.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19361">The unparsed Categories key from the desktop file;
|
|
i.e. no attempt is made to split it by ';' or validate it.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19357">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_filename" c:identifier="g_desktop_app_info_get_filename" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19366">When @info was created from a known filename, return it. In some
|
|
situations such as the #GDesktopAppInfo returned from
|
|
g_desktop_app_info_new_from_keyfile(), this function will return %NULL.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19374">The full path to the file for @info,
|
|
or %NULL if not known.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19368">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_generic_name" c:identifier="g_desktop_app_info_get_generic_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19380">Gets the generic name from the destkop file.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19386">The value of the GenericName key</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19382">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_hidden" c:identifier="g_desktop_app_info_get_is_hidden">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19405">A desktop file is hidden if the Hidden key in it is
|
|
set to True.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19412">%TRUE if hidden, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19407">a #GDesktopAppInfo.</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_keywords" c:identifier="g_desktop_app_info_get_keywords" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19416">Gets the keywords from the desktop file.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19422">The value of the Keywords key</doc>
|
|
<array c:type="const char* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19418">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_locale_string" c:identifier="g_desktop_app_info_get_locale_string" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19427">Looks up a localized string value in the keyfile backing @info
|
|
translated to the current locale.
|
|
|
|
The @key is looked up in the "Desktop Entry" group.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="86"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19437">a newly allocated string, or %NULL if the key
|
|
is not found</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19429">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19430">the key to look up</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_nodisplay" c:identifier="g_desktop_app_info_get_nodisplay" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19443">Gets the value of the NoDisplay key, which helps determine if the
|
|
application info should be shown in menus. See
|
|
#G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show().</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19451">The value of the NoDisplay key</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19445">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_show_in" c:identifier="g_desktop_app_info_get_show_in" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19456">Checks if the application info should be shown in menus that list available
|
|
applications for a specific name of the desktop, based on the
|
|
`OnlyShowIn` and `NotShowIn` keys.
|
|
|
|
@desktop_env should typically be given as %NULL, in which case the
|
|
`XDG_CURRENT_DESKTOP` environment variable is consulted. If you want
|
|
to override the default mechanism then you may specify @desktop_env,
|
|
but this is not recommended.
|
|
|
|
Note that g_app_info_should_show() for @info will include this check (with
|
|
%NULL for @desktop_env) as well as additional checks.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19473">%TRUE if the @info should be shown in @desktop_env according to the
|
|
`OnlyShowIn` and `NotShowIn` keys, %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19458">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="desktop_env" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19459">a string specifying a desktop name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_startup_wm_class" c:identifier="g_desktop_app_info_get_startup_wm_class" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19480">Retrieves the StartupWMClass field from @info. This represents the
|
|
WM_CLASS property of the main window of the application, if launched
|
|
through @info.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19488">the startup WM class, or %NULL if none is set
|
|
in the desktop file.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19482">a #GDesktopAppInfo that supports startup notify</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_string" c:identifier="g_desktop_app_info_get_string" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19494">Looks up a string value in the keyfile backing @info.
|
|
|
|
The @key is looked up in the "Desktop Entry" group.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19503">a newly allocated string, or %NULL if the key
|
|
is not found</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19496">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19497">the key to look up</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_string_list" c:identifier="g_desktop_app_info_get_string_list" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19509">Looks up a string list value in the keyfile backing @info.
|
|
|
|
The @key is looked up in the "Desktop Entry" group.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="93"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19519">
|
|
a %NULL-terminated string array or %NULL if the specified
|
|
key cannot be found. The array should be freed with g_strfreev().</doc>
|
|
<array length="1" zero-terminated="1" c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19511">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19512">the key to look up</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19513">return location for the number of returned strings, or %NULL</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_key" c:identifier="g_desktop_app_info_has_key" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19526">Returns whether @key exists in the "Desktop Entry" group
|
|
of the keyfile backing @info.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19534">%TRUE if the @key exists</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19528">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19529">the key to look up</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch_action" c:identifier="g_desktop_app_info_launch_action" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19539">Activates the named application action.
|
|
|
|
You may only call this function on action names that were
|
|
returned from g_desktop_app_info_list_actions().
|
|
|
|
Note that if the main entry of the desktop file indicates that the
|
|
application supports startup notification, and @launch_context is
|
|
non-%NULL, then startup notification will be used when activating the
|
|
action (and as such, invocation of the action on the receiving side
|
|
must signal the end of startup notification when it is completed).
|
|
This is the expected behaviour of applications declaring additional
|
|
actions, as per the desktop file specification.
|
|
|
|
As with g_app_info_launch() there is no way to detect failures that
|
|
occur while using this function.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19541">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19542">the name of the action as from
|
|
g_desktop_app_info_list_actions()</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="launch_context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19544">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch_uris_as_manager" c:identifier="g_desktop_app_info_launch_uris_as_manager" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19566">This function performs the equivalent of g_app_info_launch_uris(),
|
|
but is intended primarily for operating system components that
|
|
launch applications. Ordinary applications should use
|
|
g_app_info_launch_uris().
|
|
|
|
If the application is launched via GSpawn, then @spawn_flags, @user_setup
|
|
and @user_setup_data are used for the call to g_spawn_async().
|
|
Additionally, @pid_callback (with @pid_callback_data) will be called to
|
|
inform about the PID of the created process. See g_spawn_async_with_pipes()
|
|
for information on certain parameter conditions that can enable an
|
|
optimized posix_spawn() codepath to be used.
|
|
|
|
If application launching occurs via some other mechanism (eg: D-Bus
|
|
activation) then @spawn_flags, @user_setup, @user_setup_data,
|
|
@pid_callback and @pid_callback_data are ignored.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19595">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19568">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="uris" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19569">List of URIs</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="launch_context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19570">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="spawn_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19571">#GSpawnFlags, used for each process</doc>
|
|
<type name="GLib.SpawnFlags" c:type="GSpawnFlags"/>
|
|
</parameter>
|
|
<parameter name="user_setup" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19572">a #GSpawnChildSetupFunc, used once
|
|
for each process.</doc>
|
|
<type name="GLib.SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
|
|
</parameter>
|
|
<parameter name="user_setup_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19574">User data for @user_setup</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="pid_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19575">Callback for child processes</doc>
|
|
<type name="DesktopAppLaunchCallback" c:type="GDesktopAppLaunchCallback"/>
|
|
</parameter>
|
|
<parameter name="pid_callback_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19576">User data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="launch_uris_as_manager_with_fds" c:identifier="g_desktop_app_info_launch_uris_as_manager_with_fds" version="2.58" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19599">Equivalent to g_desktop_app_info_launch_uris_as_manager() but allows
|
|
you to pass in file descriptors for the stdin, stdout and stderr streams
|
|
of the launched process.
|
|
|
|
If application launching occurs via some non-spawn mechanism (e.g. D-Bus
|
|
activation) then @stdin_fd, @stdout_fd and @stderr_fd are ignored.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="177"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19622">%TRUE on successful launch, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19601">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="uris" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19602">List of URIs</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</parameter>
|
|
<parameter name="launch_context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19603">a #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="spawn_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19604">#GSpawnFlags, used for each process</doc>
|
|
<type name="GLib.SpawnFlags" c:type="GSpawnFlags"/>
|
|
</parameter>
|
|
<parameter name="user_setup" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19605">a #GSpawnChildSetupFunc, used once
|
|
for each process.</doc>
|
|
<type name="GLib.SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
|
|
</parameter>
|
|
<parameter name="user_setup_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19607">User data for @user_setup</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="pid_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19608">Callback for child processes</doc>
|
|
<type name="DesktopAppLaunchCallback" c:type="GDesktopAppLaunchCallback"/>
|
|
</parameter>
|
|
<parameter name="pid_callback_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19609">User data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="stdin_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19610">file descriptor to use for child's stdin, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="stdout_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19611">file descriptor to use for child's stdout, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="stderr_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19612">file descriptor to use for child's stderr, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="list_actions" c:identifier="g_desktop_app_info_list_actions" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19627">Returns the list of "additional application actions" supported on the
|
|
desktop file, as per the desktop file specification.
|
|
|
|
As per the specification, this is the list of actions that are
|
|
explicitly listed in the "Actions" key of the [Desktop Entry] group.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19637">a list of strings, always non-%NULL</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19629">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="filename" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1477">The origin filename of this #GDesktopAppInfo</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
</class>
|
|
<record name="DesktopAppInfoClass" c:type="GDesktopAppInfoClass" glib:is-gtype-struct-for="DesktopAppInfo">
|
|
<source-position filename="gdesktopappinfo.h" line="43"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<interface name="DesktopAppInfoLookup" c:symbol-prefix="desktop_app_info_lookup" c:type="GDesktopAppInfoLookup" deprecated="1" deprecated-version="2.28" glib:type-name="GDesktopAppInfoLookup" glib:get-type="g_desktop_app_info_lookup_get_type" glib:type-struct="DesktopAppInfoLookupIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1484">#GDesktopAppInfoLookup is an opaque data structure and can only be accessed
|
|
using the following functions.</doc>
|
|
<doc-deprecated xml:space="preserve">The #GDesktopAppInfoLookup interface is deprecated and
|
|
unused by GIO.</doc-deprecated>
|
|
<source-position filename="gdesktopappinfo.h" line="142"/>
|
|
<virtual-method name="get_default_for_uri_scheme" invoker="get_default_for_uri_scheme" deprecated="1" deprecated-version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19642">Gets the default application for launching applications
|
|
using this URI scheme for a particular #GDesktopAppInfoLookup
|
|
implementation.
|
|
|
|
The #GDesktopAppInfoLookup interface and this function is used
|
|
to implement g_app_info_get_default_for_uri_scheme() backends
|
|
in a GIO module. There is no reason for applications to use it
|
|
directly. Applications should use g_app_info_get_default_for_uri_scheme().</doc>
|
|
<doc-deprecated xml:space="preserve">The #GDesktopAppInfoLookup interface is deprecated and
|
|
unused by GIO.</doc-deprecated>
|
|
<source-position filename="gdesktopappinfo.h" line="140"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19656">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="lookup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19644">a #GDesktopAppInfoLookup</doc>
|
|
<type name="DesktopAppInfoLookup" c:type="GDesktopAppInfoLookup*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19645">a string containing a URI scheme.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_default_for_uri_scheme" c:identifier="g_desktop_app_info_lookup_get_default_for_uri_scheme" deprecated="1" deprecated-version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19642">Gets the default application for launching applications
|
|
using this URI scheme for a particular #GDesktopAppInfoLookup
|
|
implementation.
|
|
|
|
The #GDesktopAppInfoLookup interface and this function is used
|
|
to implement g_app_info_get_default_for_uri_scheme() backends
|
|
in a GIO module. There is no reason for applications to use it
|
|
directly. Applications should use g_app_info_get_default_for_uri_scheme().</doc>
|
|
<doc-deprecated xml:space="preserve">The #GDesktopAppInfoLookup interface is deprecated and
|
|
unused by GIO.</doc-deprecated>
|
|
<source-position filename="gdesktopappinfo.h" line="148"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19656">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="lookup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19644">a #GDesktopAppInfoLookup</doc>
|
|
<type name="DesktopAppInfoLookup" c:type="GDesktopAppInfoLookup*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19645">a string containing a URI scheme.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="DesktopAppInfoLookupIface" c:type="GDesktopAppInfoLookupIface" glib:is-gtype-struct-for="DesktopAppInfoLookup">
|
|
<doc xml:space="preserve" filename="gdesktopappinfo.h" line="125">Interface that is used by backends to associate default
|
|
handlers with URI schemes.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="142"/>
|
|
<field name="g_iface">
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_default_for_uri_scheme">
|
|
<callback name="get_default_for_uri_scheme">
|
|
<source-position filename="gdesktopappinfo.h" line="140"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19656">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="lookup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19644">a #GDesktopAppInfoLookup</doc>
|
|
<type name="DesktopAppInfoLookup" c:type="GDesktopAppInfoLookup*"/>
|
|
</parameter>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19645">a string containing a URI scheme.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<callback name="DesktopAppLaunchCallback" c:type="GDesktopAppLaunchCallback">
|
|
<doc xml:space="preserve" filename="gdesktopappinfo.h" line="151">During invocation, g_desktop_app_info_launch_uris_as_manager() may
|
|
create one or more child processes. This callback is invoked once
|
|
for each, providing the process ID.</doc>
|
|
<source-position filename="gdesktopappinfo.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="appinfo" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdesktopappinfo.h" line="153">a #GDesktopAppInfo</doc>
|
|
<type name="DesktopAppInfo" c:type="GDesktopAppInfo*"/>
|
|
</parameter>
|
|
<parameter name="pid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gdesktopappinfo.h" line="154">Process identifier</doc>
|
|
<type name="GLib.Pid" c:type="GPid"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gdesktopappinfo.h" line="155">User data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<interface name="Drive" c:symbol-prefix="drive" c:type="GDrive" glib:type-name="GDrive" glib:get-type="g_drive_get_type" glib:type-struct="DriveIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6017">#GDrive - this represent a piece of hardware connected to the machine.
|
|
It's generally only created for removable hardware or hardware with
|
|
removable media.
|
|
|
|
#GDrive is a container class for #GVolume objects that stem from
|
|
the same piece of media. As such, #GDrive abstracts a drive with
|
|
(or without) removable media and provides operations for querying
|
|
whether media is available, determining whether media change is
|
|
automatically detected and ejecting the media.
|
|
|
|
If the #GDrive reports that media isn't automatically detected, one
|
|
can poll for media; typically one should not do this periodically
|
|
as a poll for media operation is potententially expensive and may
|
|
spin up the drive creating noise.
|
|
|
|
#GDrive supports starting and stopping drives with authentication
|
|
support for the former. This can be used to support a diverse set
|
|
of use cases including connecting/disconnecting iSCSI devices,
|
|
powering down external disk enclosures and starting/stopping
|
|
multi-disk devices such as RAID devices. Note that the actual
|
|
semantics and side-effects of starting/stopping a #GDrive may vary
|
|
according to implementation. To choose the correct verbs in e.g. a
|
|
file manager, use g_drive_get_start_stop_type().
|
|
|
|
For porting from GnomeVFS note that there is no equivalent of
|
|
#GDrive in that API.</doc>
|
|
<source-position filename="gdrive.h" line="169"/>
|
|
<virtual-method name="can_eject" invoker="can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19741">Checks if a drive can be ejected.</doc>
|
|
<source-position filename="gdrive.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19747">%TRUE if the @drive can be ejected, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19743">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_poll_for_media" invoker="can_poll_for_media">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19751">Checks if a drive can be polled for media changes.</doc>
|
|
<source-position filename="gdrive.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19757">%TRUE if the @drive can be polled for media changes,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19753">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_start" invoker="can_start" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19762">Checks if a drive can be started.</doc>
|
|
<source-position filename="gdrive.h" line="130"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19768">%TRUE if the @drive can be started, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19764">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_start_degraded" invoker="can_start_degraded" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19773">Checks if a drive can be started degraded.</doc>
|
|
<source-position filename="gdrive.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19779">%TRUE if the @drive can be started degraded, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19775">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_stop" invoker="can_stop" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19784">Checks if a drive can be stopped.</doc>
|
|
<source-position filename="gdrive.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19790">%TRUE if the @drive can be stopped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19786">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="changed">
|
|
<source-position filename="gdrive.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="disconnected">
|
|
<source-position filename="gdrive.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject" invoker="eject" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19795">Asynchronously ejects a drive.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_eject_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_drive_eject_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gdrive.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19797">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19798">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19799">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19800">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19801">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_button">
|
|
<source-position filename="gdrive.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_finish" invoker="eject_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19813">Finishes ejecting a drive.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_drive_eject_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gdrive.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19821">%TRUE if the drive has been ejected successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19815">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19816">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_with_operation" invoker="eject_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19827">Ejects a drive. This is an asynchronous operation, and is
|
|
finished by calling g_drive_eject_with_operation_finish() with the @drive
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gdrive.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19829">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19830">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19831">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19833">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19834">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19835">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_with_operation_finish" invoker="eject_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19845">Finishes ejecting a drive. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gdrive.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19855">%TRUE if the drive was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19847">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19848">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="enumerate_identifiers" invoker="enumerate_identifiers">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19860">Gets the kinds of identifiers that @drive has.
|
|
Use g_drive_get_identifier() to obtain the identifiers
|
|
themselves.</doc>
|
|
<source-position filename="gdrive.h" line="126"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19868">a %NULL-terminated
|
|
array of strings containing kinds of identifiers. Use g_strfreev()
|
|
to free.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19862">a #GDrive</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_icon" invoker="get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19874">Gets the icon for @drive.</doc>
|
|
<source-position filename="gdrive.h" line="100"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19880">#GIcon for the @drive.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19876">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_identifier" invoker="get_identifier">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19885">Gets the identifier of the given kind for @drive. The only
|
|
identifier currently available is
|
|
#G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE.</doc>
|
|
<source-position filename="gdrive.h" line="124"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19894">a newly allocated string containing the
|
|
requested identifier, or %NULL if the #GDrive
|
|
doesn't have this kind of identifier.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19887">a #GDrive</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="kind" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19888">the kind of identifier to return</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_name" invoker="get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19900">Gets the name of @drive.</doc>
|
|
<source-position filename="gdrive.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19906">a string containing @drive's name. The returned
|
|
string should be freed when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19902">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_sort_key" invoker="get_sort_key" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19911">Gets the sort key for @drive, if any.</doc>
|
|
<source-position filename="gdrive.h" line="165"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19917">Sorting key for @drive or %NULL if no such key is available.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19913">A #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_start_stop_type" invoker="get_start_stop_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19922">Gets a hint about how a drive can be started/stopped.</doc>
|
|
<source-position filename="gdrive.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19928">A value from the #GDriveStartStopType enumeration.</doc>
|
|
<type name="DriveStartStopType" c:type="GDriveStartStopType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19924">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_symbolic_icon" invoker="get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19933">Gets the icon for @drive.</doc>
|
|
<source-position filename="gdrive.h" line="166"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19939">symbolic #GIcon for the @drive.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19935">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_volumes" invoker="get_volumes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19945">Get a list of mountable volumes for @drive.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gdrive.h" line="102"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19954">#GList containing any #GVolume objects on the given @drive.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Volume"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19947">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="has_media" invoker="has_media">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19958">Checks if the @drive has media. Note that the OS may not be polling
|
|
the drive for media changes; see g_drive_is_media_check_automatic()
|
|
for more details.</doc>
|
|
<source-position filename="gdrive.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19966">%TRUE if @drive has media, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19960">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="has_volumes" invoker="has_volumes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19970">Check if @drive has any mountable volumes.</doc>
|
|
<source-position filename="gdrive.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19976">%TRUE if the @drive contains volumes, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19972">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_media_check_automatic" invoker="is_media_check_automatic">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19980">Checks if @drive is capabable of automatically detecting media changes.</doc>
|
|
<source-position filename="gdrive.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19986">%TRUE if the @drive is capabable of automatically detecting
|
|
media changes, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19982">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_media_removable" invoker="is_media_removable">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19991">Checks if the @drive supports removable media.</doc>
|
|
<source-position filename="gdrive.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19997">%TRUE if @drive supports removable media, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19993">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_removable" invoker="is_removable" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20001">Checks if the #GDrive and/or its media is considered removable by the user.
|
|
See g_drive_is_media_removable().</doc>
|
|
<source-position filename="gdrive.h" line="167"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20008">%TRUE if @drive and/or its media is considered removable, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20003">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="poll_for_media" invoker="poll_for_media">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20013">Asynchronously polls @drive to see if media has been inserted or removed.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_poll_for_media_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<source-position filename="gdrive.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20015">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20016">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20017">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20018">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="poll_for_media_finish" invoker="poll_for_media_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20028">Finishes an operation started with g_drive_poll_for_media() on a drive.</doc>
|
|
<source-position filename="gdrive.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20036">%TRUE if the drive has been poll_for_mediaed successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20030">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20031">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start" invoker="start" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20041">Asynchronously starts a drive.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_start_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<source-position filename="gdrive.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20043">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20044">flags affecting the start operation.</doc>
|
|
<type name="DriveStartFlags" c:type="GDriveStartFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20045">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20047">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20048">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20049">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start_finish" invoker="start_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20061">Finishes starting a drive.</doc>
|
|
<source-position filename="gdrive.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20069">%TRUE if the drive has been started successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20063">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20064">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop" invoker="stop" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20075">Asynchronously stops a drive.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_stop_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<source-position filename="gdrive.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20077">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20078">flags affecting the unmount if required for stopping.</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20079">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20081">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20082">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20083">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop_button">
|
|
<source-position filename="gdrive.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop_finish" invoker="stop_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20095">Finishes stopping a drive.</doc>
|
|
<source-position filename="gdrive.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20103">%TRUE if the drive has been stopped successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20097">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20098">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="can_eject" c:identifier="g_drive_can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19741">Checks if a drive can be ejected.</doc>
|
|
<source-position filename="gdrive.h" line="195"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19747">%TRUE if the @drive can be ejected, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19743">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_poll_for_media" c:identifier="g_drive_can_poll_for_media">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19751">Checks if a drive can be polled for media changes.</doc>
|
|
<source-position filename="gdrive.h" line="193"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19757">%TRUE if the @drive can be polled for media changes,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19753">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_start" c:identifier="g_drive_can_start" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19762">Checks if a drive can be started.</doc>
|
|
<source-position filename="gdrive.h" line="226"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19768">%TRUE if the @drive can be started, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19764">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_start_degraded" c:identifier="g_drive_can_start_degraded" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19773">Checks if a drive can be started degraded.</doc>
|
|
<source-position filename="gdrive.h" line="228"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19779">%TRUE if the @drive can be started degraded, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19775">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_stop" c:identifier="g_drive_can_stop" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19784">Checks if a drive can be stopped.</doc>
|
|
<source-position filename="gdrive.h" line="242"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19790">%TRUE if the @drive can be stopped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19786">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject" c:identifier="g_drive_eject" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19795">Asynchronously ejects a drive.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_eject_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_drive_eject_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gdrive.h" line="197"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19797">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19798">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19799">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19800">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19801">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_finish" c:identifier="g_drive_eject_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19813">Finishes ejecting a drive.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_drive_eject_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gdrive.h" line="204"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19821">%TRUE if the drive has been ejected successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19815">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19816">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_with_operation" c:identifier="g_drive_eject_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19827">Ejects a drive. This is an asynchronous operation, and is
|
|
finished by calling g_drive_eject_with_operation_finish() with the @drive
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gdrive.h" line="256"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19829">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19830">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19831">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19833">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19834">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19835">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_with_operation_finish" c:identifier="g_drive_eject_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19845">Finishes ejecting a drive. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gdrive.h" line="263"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19855">%TRUE if the drive was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19847">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19848">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="enumerate_identifiers" c:identifier="g_drive_enumerate_identifiers">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19860">Gets the kinds of identifiers that @drive has.
|
|
Use g_drive_get_identifier() to obtain the identifiers
|
|
themselves.</doc>
|
|
<source-position filename="gdrive.h" line="220"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19868">a %NULL-terminated
|
|
array of strings containing kinds of identifiers. Use g_strfreev()
|
|
to free.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19862">a #GDrive</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_icon" c:identifier="g_drive_get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19874">Gets the icon for @drive.</doc>
|
|
<source-position filename="gdrive.h" line="177"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19880">#GIcon for the @drive.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19876">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_identifier" c:identifier="g_drive_get_identifier">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19885">Gets the identifier of the given kind for @drive. The only
|
|
identifier currently available is
|
|
#G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE.</doc>
|
|
<source-position filename="gdrive.h" line="217"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19894">a newly allocated string containing the
|
|
requested identifier, or %NULL if the #GDrive
|
|
doesn't have this kind of identifier.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19887">a #GDrive</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="kind" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19888">the kind of identifier to return</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_drive_get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19900">Gets the name of @drive.</doc>
|
|
<source-position filename="gdrive.h" line="175"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19906">a string containing @drive's name. The returned
|
|
string should be freed when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19902">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sort_key" c:identifier="g_drive_get_sort_key" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19911">Gets the sort key for @drive, if any.</doc>
|
|
<source-position filename="gdrive.h" line="268"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19917">Sorting key for @drive or %NULL if no such key is available.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19913">A #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_start_stop_type" c:identifier="g_drive_get_start_stop_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19922">Gets a hint about how a drive can be started/stopped.</doc>
|
|
<source-position filename="gdrive.h" line="223"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19928">A value from the #GDriveStartStopType enumeration.</doc>
|
|
<type name="DriveStartStopType" c:type="GDriveStartStopType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19924">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_symbolic_icon" c:identifier="g_drive_get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19933">Gets the icon for @drive.</doc>
|
|
<source-position filename="gdrive.h" line="179"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19939">symbolic #GIcon for the @drive.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19935">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_volumes" c:identifier="g_drive_get_volumes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19945">Get a list of mountable volumes for @drive.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gdrive.h" line="183"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19954">#GList containing any #GVolume objects on the given @drive.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Volume"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19947">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_media" c:identifier="g_drive_has_media">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19958">Checks if the @drive has media. Note that the OS may not be polling
|
|
the drive for media changes; see g_drive_is_media_check_automatic()
|
|
for more details.</doc>
|
|
<source-position filename="gdrive.h" line="189"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19966">%TRUE if @drive has media, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19960">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_volumes" c:identifier="g_drive_has_volumes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19970">Check if @drive has any mountable volumes.</doc>
|
|
<source-position filename="gdrive.h" line="181"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19976">%TRUE if the @drive contains volumes, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19972">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_media_check_automatic" c:identifier="g_drive_is_media_check_automatic">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19980">Checks if @drive is capabable of automatically detecting media changes.</doc>
|
|
<source-position filename="gdrive.h" line="191"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19986">%TRUE if the @drive is capabable of automatically detecting
|
|
media changes, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19982">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_media_removable" c:identifier="g_drive_is_media_removable">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19991">Checks if the @drive supports removable media.</doc>
|
|
<source-position filename="gdrive.h" line="187"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19997">%TRUE if @drive supports removable media, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19993">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_removable" c:identifier="g_drive_is_removable" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20001">Checks if the #GDrive and/or its media is considered removable by the user.
|
|
See g_drive_is_media_removable().</doc>
|
|
<source-position filename="gdrive.h" line="185"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20008">%TRUE if @drive and/or its media is considered removable, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20003">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="poll_for_media" c:identifier="g_drive_poll_for_media">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20013">Asynchronously polls @drive to see if media has been inserted or removed.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_poll_for_media_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<source-position filename="gdrive.h" line="208"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20015">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20016">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20017">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20018">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="poll_for_media_finish" c:identifier="g_drive_poll_for_media_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20028">Finishes an operation started with g_drive_poll_for_media() on a drive.</doc>
|
|
<source-position filename="gdrive.h" line="213"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20036">%TRUE if the drive has been poll_for_mediaed successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20030">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20031">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start" c:identifier="g_drive_start" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20041">Asynchronously starts a drive.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_start_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<source-position filename="gdrive.h" line="230"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20043">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20044">flags affecting the start operation.</doc>
|
|
<type name="DriveStartFlags" c:type="GDriveStartFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20045">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20047">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20048">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20049">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start_finish" c:identifier="g_drive_start_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20061">Finishes starting a drive.</doc>
|
|
<source-position filename="gdrive.h" line="237"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20069">%TRUE if the drive has been started successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20063">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20064">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop" c:identifier="g_drive_stop" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20075">Asynchronously stops a drive.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_drive_stop_finish() to obtain the
|
|
result of the operation.</doc>
|
|
<source-position filename="gdrive.h" line="244"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20077">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20078">flags affecting the unmount if required for stopping.</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20079">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20081">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20082">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20083">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop_finish" c:identifier="g_drive_stop_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20095">Finishes stopping a drive.</doc>
|
|
<source-position filename="gdrive.h" line="251"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20103">%TRUE if the drive has been stopped successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20097">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20098">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1495">Emitted when the drive's state has changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="disconnected" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1503">This signal is emitted when the #GDrive have been
|
|
disconnected. If the recipient is holding references to the
|
|
object they should release them so the object can be
|
|
finalized.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="eject-button" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1514">Emitted when the physical eject button (if any) of a drive has
|
|
been pressed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="stop-button" when="last" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1523">Emitted when the physical stop button (if any) of a drive has
|
|
been pressed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="DriveIface" c:type="GDriveIface" glib:is-gtype-struct-for="Drive">
|
|
<doc xml:space="preserve" filename="gdrive.h" line="47">Interface for creating #GDrive implementations.</doc>
|
|
<source-position filename="gdrive.h" line="169"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gdrive.h" line="49">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="changed">
|
|
<callback name="changed">
|
|
<source-position filename="gdrive.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="disconnected">
|
|
<callback name="disconnected">
|
|
<source-position filename="gdrive.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_button">
|
|
<callback name="eject_button">
|
|
<source-position filename="gdrive.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_name">
|
|
<callback name="get_name">
|
|
<source-position filename="gdrive.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19906">a string containing @drive's name. The returned
|
|
string should be freed when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19902">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_icon">
|
|
<callback name="get_icon">
|
|
<source-position filename="gdrive.h" line="100"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19880">#GIcon for the @drive.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19876">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="has_volumes">
|
|
<callback name="has_volumes">
|
|
<source-position filename="gdrive.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19976">%TRUE if the @drive contains volumes, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19972">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_volumes">
|
|
<callback name="get_volumes">
|
|
<source-position filename="gdrive.h" line="102"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19954">#GList containing any #GVolume objects on the given @drive.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Volume"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19947">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_media_removable">
|
|
<callback name="is_media_removable">
|
|
<source-position filename="gdrive.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19997">%TRUE if @drive supports removable media, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19993">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="has_media">
|
|
<callback name="has_media">
|
|
<source-position filename="gdrive.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19966">%TRUE if @drive has media, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19960">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_media_check_automatic">
|
|
<callback name="is_media_check_automatic">
|
|
<source-position filename="gdrive.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19986">%TRUE if the @drive is capabable of automatically detecting
|
|
media changes, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19982">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_eject">
|
|
<callback name="can_eject">
|
|
<source-position filename="gdrive.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19747">%TRUE if the @drive can be ejected, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19743">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_poll_for_media">
|
|
<callback name="can_poll_for_media">
|
|
<source-position filename="gdrive.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19757">%TRUE if the @drive can be polled for media changes,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19753">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject">
|
|
<callback name="eject">
|
|
<source-position filename="gdrive.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19797">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19798">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19799">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19800">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19801">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_finish">
|
|
<callback name="eject_finish" throws="1">
|
|
<source-position filename="gdrive.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19821">%TRUE if the drive has been ejected successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19815">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19816">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="poll_for_media">
|
|
<callback name="poll_for_media">
|
|
<source-position filename="gdrive.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20015">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20016">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20017">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20018">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="poll_for_media_finish">
|
|
<callback name="poll_for_media_finish" throws="1">
|
|
<source-position filename="gdrive.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20036">%TRUE if the drive has been poll_for_mediaed successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20030">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20031">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_identifier">
|
|
<callback name="get_identifier">
|
|
<source-position filename="gdrive.h" line="124"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19894">a newly allocated string containing the
|
|
requested identifier, or %NULL if the #GDrive
|
|
doesn't have this kind of identifier.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19887">a #GDrive</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="kind" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19888">the kind of identifier to return</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="enumerate_identifiers">
|
|
<callback name="enumerate_identifiers">
|
|
<source-position filename="gdrive.h" line="126"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19868">a %NULL-terminated
|
|
array of strings containing kinds of identifiers. Use g_strfreev()
|
|
to free.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19862">a #GDrive</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_start_stop_type">
|
|
<callback name="get_start_stop_type">
|
|
<source-position filename="gdrive.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19928">A value from the #GDriveStartStopType enumeration.</doc>
|
|
<type name="DriveStartStopType" c:type="GDriveStartStopType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19924">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_start">
|
|
<callback name="can_start">
|
|
<source-position filename="gdrive.h" line="130"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19768">%TRUE if the @drive can be started, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19764">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_start_degraded">
|
|
<callback name="can_start_degraded">
|
|
<source-position filename="gdrive.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19779">%TRUE if the @drive can be started degraded, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19775">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start">
|
|
<callback name="start">
|
|
<source-position filename="gdrive.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20043">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20044">flags affecting the start operation.</doc>
|
|
<type name="DriveStartFlags" c:type="GDriveStartFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20045">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20047">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20048">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20049">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start_finish">
|
|
<callback name="start_finish" throws="1">
|
|
<source-position filename="gdrive.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20069">%TRUE if the drive has been started successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20063">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20064">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_stop">
|
|
<callback name="can_stop">
|
|
<source-position filename="gdrive.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19790">%TRUE if the @drive can be stopped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19786">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop">
|
|
<callback name="stop">
|
|
<source-position filename="gdrive.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20077">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20078">flags affecting the unmount if required for stopping.</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20079">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20081">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20082">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20083">user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop_finish">
|
|
<callback name="stop_finish" throws="1">
|
|
<source-position filename="gdrive.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20103">%TRUE if the drive has been stopped successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20097">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20098">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop_button">
|
|
<callback name="stop_button">
|
|
<source-position filename="gdrive.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_with_operation">
|
|
<callback name="eject_with_operation">
|
|
<source-position filename="gdrive.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19829">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19830">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19831">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19833">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19834">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19835">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_with_operation_finish">
|
|
<callback name="eject_with_operation_finish" throws="1">
|
|
<source-position filename="gdrive.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19855">%TRUE if the drive was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19847">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19848">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_sort_key">
|
|
<callback name="get_sort_key">
|
|
<source-position filename="gdrive.h" line="165"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19917">Sorting key for @drive or %NULL if no such key is available.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19913">A #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_symbolic_icon">
|
|
<callback name="get_symbolic_icon">
|
|
<source-position filename="gdrive.h" line="166"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19939">symbolic #GIcon for the @drive.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="19935">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_removable">
|
|
<callback name="is_removable">
|
|
<source-position filename="gdrive.h" line="167"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20008">%TRUE if @drive and/or its media is considered removable, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20003">a #GDrive.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<bitfield name="DriveStartFlags" version="2.22" glib:type-name="GDriveStartFlags" glib:get-type="g_drive_start_flags_get_type" c:type="GDriveStartFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="260">Flags used when starting a drive.</doc>
|
|
<member name="none" value="0" c:identifier="G_DRIVE_START_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="262">No flags set.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<enumeration name="DriveStartStopType" version="2.22" glib:type-name="GDriveStartStopType" glib:get-type="g_drive_start_stop_type_get_type" c:type="GDriveStartStopType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="272">Enumeration describing how a drive can be started/stopped.</doc>
|
|
<member name="unknown" value="0" c:identifier="G_DRIVE_START_STOP_TYPE_UNKNOWN" glib:nick="unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="274">Unknown or drive doesn't support
|
|
start/stop.</doc>
|
|
</member>
|
|
<member name="shutdown" value="1" c:identifier="G_DRIVE_START_STOP_TYPE_SHUTDOWN" glib:nick="shutdown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="276">The stop method will physically
|
|
shut down the drive and e.g. power down the port the drive is
|
|
attached to.</doc>
|
|
</member>
|
|
<member name="network" value="2" c:identifier="G_DRIVE_START_STOP_TYPE_NETWORK" glib:nick="network">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="279">The start/stop methods are used
|
|
for connecting/disconnect to the drive over the network.</doc>
|
|
</member>
|
|
<member name="multidisk" value="3" c:identifier="G_DRIVE_START_STOP_TYPE_MULTIDISK" glib:nick="multidisk">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="281">The start/stop methods will
|
|
assemble/disassemble a virtual drive from several physical
|
|
drives.</doc>
|
|
</member>
|
|
<member name="password" value="4" c:identifier="G_DRIVE_START_STOP_TYPE_PASSWORD" glib:nick="password">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="284">The start/stop methods will
|
|
unlock/lock the disk (for example using the ATA <quote>SECURITY
|
|
UNLOCK DEVICE</quote> command)</doc>
|
|
</member>
|
|
</enumeration>
|
|
<interface name="DtlsClientConnection" c:symbol-prefix="dtls_client_connection" c:type="GDtlsClientConnection" version="2.48" glib:type-name="GDtlsClientConnection" glib:get-type="g_dtls_client_connection_get_type" glib:type-struct="DtlsClientConnectionInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6051">#GDtlsClientConnection is the client-side subclass of
|
|
#GDtlsConnection, representing a client-side DTLS connection.</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="49"/>
|
|
<prerequisite name="DatagramBased"/>
|
|
<prerequisite name="DtlsConnection"/>
|
|
<function name="new" c:identifier="g_dtls_client_connection_new" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20152">Creates a new #GDtlsClientConnection wrapping @base_socket which is
|
|
assumed to communicate with the server identified by @server_identity.</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20161">the new
|
|
#GDtlsClientConnection, or %NULL on error</doc>
|
|
<type name="DtlsClientConnection" c:type="GDatagramBased*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20154">the #GDatagramBased to wrap</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="server_identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20155">the expected identity of the server</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="get_accepted_cas" c:identifier="g_dtls_client_connection_get_accepted_cas" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20109">Gets the list of distinguished names of the Certificate Authorities
|
|
that the server will accept certificates from. This will be set
|
|
during the TLS handshake if the server requests a certificate.
|
|
Otherwise, it will be %NULL.
|
|
|
|
Each item in the list is a #GByteArray which contains the complete
|
|
subject DN of the certificate authority.</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20121">the list of
|
|
CA DNs. You should unref each element with g_byte_array_unref() and then
|
|
the free the list with g_list_free().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<array name="GLib.ByteArray">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20111">the #GDtlsClientConnection</doc>
|
|
<type name="DtlsClientConnection" c:type="GDtlsClientConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_server_identity" c:identifier="g_dtls_client_connection_get_server_identity" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20128">Gets @conn's expected server identity</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20134">a #GSocketConnectable describing the
|
|
expected server identity, or %NULL if the expected identity is not
|
|
known.</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20130">the #GDtlsClientConnection</doc>
|
|
<type name="DtlsClientConnection" c:type="GDtlsClientConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_validation_flags" c:identifier="g_dtls_client_connection_get_validation_flags" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20141">Gets @conn's validation flags</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20147">the validation flags</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20143">the #GDtlsClientConnection</doc>
|
|
<type name="DtlsClientConnection" c:type="GDtlsClientConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_server_identity" c:identifier="g_dtls_client_connection_set_server_identity" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20167">Sets @conn's expected server identity, which is used both to tell
|
|
servers on virtual hosts which certificate to present, and also
|
|
to let @conn know what name to look for in the certificate when
|
|
performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20169">the #GDtlsClientConnection</doc>
|
|
<type name="DtlsClientConnection" c:type="GDtlsClientConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="identity" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20170">a #GSocketConnectable describing the expected server identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_validation_flags" c:identifier="g_dtls_client_connection_set_validation_flags" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20181">Sets @conn's validation flags, to override the default set of
|
|
checks performed when validating a server certificate. By default,
|
|
%G_TLS_CERTIFICATE_VALIDATE_ALL is used.</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20183">the #GDtlsClientConnection</doc>
|
|
<type name="DtlsClientConnection" c:type="GDtlsClientConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20184">the #GTlsCertificateFlags to use</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="accepted-cas" version="2.48" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1544">A list of the distinguished names of the Certificate Authorities
|
|
that the server will accept client certificates signed by. If the
|
|
server requests a client certificate during the handshake, then
|
|
this property will be set after the handshake completes.
|
|
|
|
Each item in the list is a #GByteArray which contains the complete
|
|
subject DN of the certificate authority.</doc>
|
|
<type name="GLib.List" c:type="gpointer">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</property>
|
|
<property name="server-identity" version="2.48" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1559">A #GSocketConnectable describing the identity of the server that
|
|
is expected on the other end of the connection.
|
|
|
|
If the %G_TLS_CERTIFICATE_BAD_IDENTITY flag is set in
|
|
#GDtlsClientConnection:validation-flags, this object will be used
|
|
to determine the expected identify of the remote end of the
|
|
connection; if #GDtlsClientConnection:server-identity is not set,
|
|
or does not match the identity presented by the server, then the
|
|
%G_TLS_CERTIFICATE_BAD_IDENTITY validation will fail.
|
|
|
|
In addition to its use in verifying the server certificate,
|
|
this is also used to give a hint to the server about what
|
|
certificate we expect, which is useful for servers that serve
|
|
virtual hosts.</doc>
|
|
<type name="SocketConnectable"/>
|
|
</property>
|
|
<property name="validation-flags" version="2.48" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1581">What steps to perform when validating a certificate received from
|
|
a server. Server certificates that fail to validate in all of the
|
|
ways indicated here will be rejected unless the application
|
|
overrides the default via #GDtlsConnection::accept-certificate.</doc>
|
|
<type name="TlsCertificateFlags"/>
|
|
</property>
|
|
</interface>
|
|
<record name="DtlsClientConnectionInterface" c:type="GDtlsClientConnectionInterface" glib:is-gtype-struct-for="DtlsClientConnection" version="2.48">
|
|
<doc xml:space="preserve" filename="gdtlsclientconnection.h" line="38">vtable for a #GDtlsClientConnection implementation.</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="49"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gdtlsclientconnection.h" line="40">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
</record>
|
|
<interface name="DtlsConnection" c:symbol-prefix="dtls_connection" c:type="GDtlsConnection" version="2.48" glib:type-name="GDtlsConnection" glib:get-type="g_dtls_connection_get_type" glib:type-struct="DtlsConnectionInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6063">#GDtlsConnection is the base DTLS connection class type, which wraps
|
|
a #GDatagramBased and provides DTLS encryption on top of it. Its
|
|
subclasses, #GDtlsClientConnection and #GDtlsServerConnection,
|
|
implement client-side and server-side DTLS, respectively.
|
|
|
|
For TLS support, see #GTlsConnection.
|
|
|
|
As DTLS is datagram based, #GDtlsConnection implements #GDatagramBased,
|
|
presenting a datagram-socket-like API for the encrypted connection. This
|
|
operates over a base datagram connection, which is also a #GDatagramBased
|
|
(#GDtlsConnection:base-socket).
|
|
|
|
To close a DTLS connection, use g_dtls_connection_close().
|
|
|
|
Neither #GDtlsServerConnection or #GDtlsClientConnection set the peer address
|
|
on their base #GDatagramBased if it is a #GSocket — it is up to the caller to
|
|
do that if they wish. If they do not, and g_socket_close() is called on the
|
|
base socket, the #GDtlsConnection will not raise a %G_IO_ERROR_NOT_CONNECTED
|
|
error on further I/O.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="98"/>
|
|
<prerequisite name="DatagramBased"/>
|
|
<virtual-method name="accept_certificate">
|
|
<source-position filename="gdtlsconnection.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_negotiated_protocol" invoker="get_negotiated_protocol" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20307">Gets the name of the application-layer protocol negotiated during
|
|
the handshake.
|
|
|
|
If the peer did not use the ALPN extension, or did not advertise a
|
|
protocol that matched one of @conn's protocols, or the TLS backend
|
|
does not support ALPN, then this will be %NULL. See
|
|
g_dtls_connection_set_advertised_protocols().</doc>
|
|
<source-position filename="gdtlsconnection.h" line="97"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20319">the negotiated protocol, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20309">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handshake" invoker="handshake" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20375">Attempts a TLS handshake on @conn.
|
|
|
|
On the client side, it is never necessary to call this method;
|
|
although the connection needs to perform a handshake after
|
|
connecting (or after sending a "STARTTLS"-type command) and may
|
|
need to rehandshake later if the server requests it,
|
|
#GDtlsConnection will handle this for you automatically when you try
|
|
to send or receive data on the connection. However, you can call
|
|
g_dtls_connection_handshake() manually if you want to know for sure
|
|
whether the initial handshake succeeded or failed (as opposed to
|
|
just immediately trying to write to @conn, in which
|
|
case if it fails, it may not be possible to tell if it failed
|
|
before or after completing the handshake).
|
|
|
|
Likewise, on the server side, although a handshake is necessary at
|
|
the beginning of the communication, you do not need to call this
|
|
function explicitly unless you want clearer error reporting.
|
|
|
|
If TLS 1.2 or older is in use, you may call
|
|
g_dtls_connection_handshake() after the initial handshake to
|
|
rehandshake; however, this usage is deprecated because rehandshaking
|
|
is no longer part of the TLS protocol in TLS 1.3. Accordingly, the
|
|
behavior of calling this function after the initial handshake is now
|
|
undefined, except it is guaranteed to be reasonable and
|
|
nondestructive so as to preserve compatibility with code written for
|
|
older versions of GLib.
|
|
|
|
#GDtlsConnection::accept_certificate may be emitted during the
|
|
handshake.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20411">success or failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20377">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20378">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handshake_async" invoker="handshake_async" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20416">Asynchronously performs a TLS handshake on @conn. See
|
|
g_dtls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20418">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20419">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20420">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20421">callback to call when the handshake is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20422">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handshake_finish" invoker="handshake_finish" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20431">Finish an asynchronous TLS handshake operation. See
|
|
g_dtls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20440">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20433">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20434">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_advertised_protocols" invoker="set_advertised_protocols" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20446">Sets the list of application-layer protocols to advertise that the
|
|
caller is willing to speak on this connection. The
|
|
Application-Layer Protocol Negotiation (ALPN) extension will be
|
|
used to negotiate a compatible protocol with the peer; use
|
|
g_dtls_connection_get_negotiated_protocol() to find the negotiated
|
|
protocol after the handshake. Specifying %NULL for the the value
|
|
of @protocols will disable ALPN negotiation.
|
|
|
|
See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids)
|
|
for a list of registered protocol IDs.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20448">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="protocols" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20449">a %NULL-terminated
|
|
array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="shutdown" invoker="shutdown" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20597">Shut down part or all of a DTLS connection.
|
|
|
|
If @shutdown_read is %TRUE then the receiving side of the connection is shut
|
|
down, and further reading is disallowed. Subsequent calls to
|
|
g_datagram_based_receive_messages() will return %G_IO_ERROR_CLOSED.
|
|
|
|
If @shutdown_write is %TRUE then the sending side of the connection is shut
|
|
down, and further writing is disallowed. Subsequent calls to
|
|
g_datagram_based_send_messages() will return %G_IO_ERROR_CLOSED.
|
|
|
|
It is allowed for both @shutdown_read and @shutdown_write to be TRUE — this
|
|
is equivalent to calling g_dtls_connection_close().
|
|
|
|
If @cancellable is cancelled, the #GDtlsConnection may be left
|
|
partially-closed and any pending untransmitted data may be lost. Call
|
|
g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20622">%TRUE on success, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20599">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="shutdown_read" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20600">%TRUE to stop reception of incoming datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="shutdown_write" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20601">%TRUE to stop sending outgoing datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20602">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="shutdown_async" invoker="shutdown_async" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20627">Asynchronously shut down part or all of the DTLS connection. See
|
|
g_dtls_connection_shutdown() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20629">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="shutdown_read" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20630">%TRUE to stop reception of incoming datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="shutdown_write" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20631">%TRUE to stop sending outgoing datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20632">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20633">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20634">callback to call when the shutdown operation is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20635">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="shutdown_finish" invoker="shutdown_finish" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20644">Finish an asynchronous TLS shutdown operation. See
|
|
g_dtls_connection_shutdown() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20653">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20646">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20647">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="close" c:identifier="g_dtls_connection_close" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20194">Close the DTLS connection. This is equivalent to calling
|
|
g_dtls_connection_shutdown() to shut down both sides of the connection.
|
|
|
|
Closing a #GDtlsConnection waits for all buffered but untransmitted data to
|
|
be sent before it completes. It then sends a `close_notify` DTLS alert to the
|
|
peer and may wait for a `close_notify` to be received from the peer. It does
|
|
not close the underlying #GDtlsConnection:base-socket; that must be closed
|
|
separately.
|
|
|
|
Once @conn is closed, all other operations will return %G_IO_ERROR_CLOSED.
|
|
Closing a #GDtlsConnection multiple times will not return an error.
|
|
|
|
#GDtlsConnections will be automatically closed when the last reference is
|
|
dropped, but you might want to call this function to make sure resources are
|
|
released as early as possible.
|
|
|
|
If @cancellable is cancelled, the #GDtlsConnection may be left
|
|
partially-closed and any pending untransmitted data may be lost. Call
|
|
g_dtls_connection_close() again to complete closing the #GDtlsConnection.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="177"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20220">%TRUE on success, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20196">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20197">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_async" c:identifier="g_dtls_connection_close_async" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20225">Asynchronously close the DTLS connection. See g_dtls_connection_close() for
|
|
more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="182"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20227">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20228">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20229">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20230">callback to call when the close operation is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20231">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_finish" c:identifier="g_dtls_connection_close_finish" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20240">Finish an asynchronous TLS close operation. See g_dtls_connection_close()
|
|
for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="188"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20249">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20242">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20243">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="emit_accept_certificate" c:identifier="g_dtls_connection_emit_accept_certificate" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20255">Used by #GDtlsConnection implementations to emit the
|
|
#GDtlsConnection::accept-certificate signal.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="194"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20264">%TRUE if one of the signal handlers has returned
|
|
%TRUE to accept @peer_cert</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20257">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20258">the peer's #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20259">the problems with @peer_cert</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_certificate" c:identifier="g_dtls_connection_get_certificate" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20270">Gets @conn's certificate, as set by
|
|
g_dtls_connection_set_certificate().</doc>
|
|
<source-position filename="gdtlsconnection.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20277">@conn's certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20272">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_database" c:identifier="g_dtls_connection_get_database" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20282">Gets the certificate database that @conn uses to verify
|
|
peer certificates. See g_dtls_connection_set_database().</doc>
|
|
<source-position filename="gdtlsconnection.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20289">the certificate database that @conn uses or %NULL</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20284">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_interaction" c:identifier="g_dtls_connection_get_interaction" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20294">Get the object that will be used to interact with the user. It will be used
|
|
for things like prompting the user for passwords. If %NULL is returned, then
|
|
no user interaction will occur for this connection.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20302">The interaction object.</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20296">a connection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_negotiated_protocol" c:identifier="g_dtls_connection_get_negotiated_protocol" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20307">Gets the name of the application-layer protocol negotiated during
|
|
the handshake.
|
|
|
|
If the peer did not use the ALPN extension, or did not advertise a
|
|
protocol that matched one of @conn's protocols, or the TLS backend
|
|
does not support ALPN, then this will be %NULL. See
|
|
g_dtls_connection_set_advertised_protocols().</doc>
|
|
<source-position filename="gdtlsconnection.h" line="202"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20319">the negotiated protocol, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20309">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_peer_certificate" c:identifier="g_dtls_connection_get_peer_certificate" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20324">Gets @conn's peer's certificate after the handshake has completed.
|
|
(It is not set during the emission of
|
|
#GDtlsConnection::accept-certificate.)</doc>
|
|
<source-position filename="gdtlsconnection.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20332">@conn's peer's certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20326">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_peer_certificate_errors" c:identifier="g_dtls_connection_get_peer_certificate_errors" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20337">Gets the errors associated with validating @conn's peer's
|
|
certificate, after the handshake has completed. (It is not set
|
|
during the emission of #GDtlsConnection::accept-certificate.)</doc>
|
|
<source-position filename="gdtlsconnection.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20345">@conn's peer's certificate errors</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20339">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_rehandshake_mode" c:identifier="g_dtls_connection_get_rehandshake_mode" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20350">Gets @conn rehandshaking mode. See
|
|
g_dtls_connection_set_rehandshake_mode() for details.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20357">@conn's rehandshaking mode</doc>
|
|
<type name="TlsRehandshakeMode" c:type="GTlsRehandshakeMode"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20352">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_require_close_notify" c:identifier="g_dtls_connection_get_require_close_notify" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20362">Tests whether or not @conn expects a proper TLS close notification
|
|
when the connection is closed. See
|
|
g_dtls_connection_set_require_close_notify() for details.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="130"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20370">%TRUE if @conn requires a proper TLS close notification.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20364">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="handshake" c:identifier="g_dtls_connection_handshake" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20375">Attempts a TLS handshake on @conn.
|
|
|
|
On the client side, it is never necessary to call this method;
|
|
although the connection needs to perform a handshake after
|
|
connecting (or after sending a "STARTTLS"-type command) and may
|
|
need to rehandshake later if the server requests it,
|
|
#GDtlsConnection will handle this for you automatically when you try
|
|
to send or receive data on the connection. However, you can call
|
|
g_dtls_connection_handshake() manually if you want to know for sure
|
|
whether the initial handshake succeeded or failed (as opposed to
|
|
just immediately trying to write to @conn, in which
|
|
case if it fails, it may not be possible to tell if it failed
|
|
before or after completing the handshake).
|
|
|
|
Likewise, on the server side, although a handshake is necessary at
|
|
the beginning of the communication, you do not need to call this
|
|
function explicitly unless you want clearer error reporting.
|
|
|
|
If TLS 1.2 or older is in use, you may call
|
|
g_dtls_connection_handshake() after the initial handshake to
|
|
rehandshake; however, this usage is deprecated because rehandshaking
|
|
is no longer part of the TLS protocol in TLS 1.3. Accordingly, the
|
|
behavior of calling this function after the initial handshake is now
|
|
undefined, except it is guaranteed to be reasonable and
|
|
nondestructive so as to preserve compatibility with code written for
|
|
older versions of GLib.
|
|
|
|
#GDtlsConnection::accept_certificate may be emitted during the
|
|
handshake.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="141"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20411">success or failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20377">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20378">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="handshake_async" c:identifier="g_dtls_connection_handshake_async" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20416">Asynchronously performs a TLS handshake on @conn. See
|
|
g_dtls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="146"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20418">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20419">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20420">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20421">callback to call when the handshake is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20422">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="handshake_finish" c:identifier="g_dtls_connection_handshake_finish" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20431">Finish an asynchronous TLS handshake operation. See
|
|
g_dtls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="152"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20440">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20433">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20434">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_advertised_protocols" c:identifier="g_dtls_connection_set_advertised_protocols" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20446">Sets the list of application-layer protocols to advertise that the
|
|
caller is willing to speak on this connection. The
|
|
Application-Layer Protocol Negotiation (ALPN) extension will be
|
|
used to negotiate a compatible protocol with the peer; use
|
|
g_dtls_connection_get_negotiated_protocol() to find the negotiated
|
|
protocol after the handshake. Specifying %NULL for the the value
|
|
of @protocols will disable ALPN negotiation.
|
|
|
|
See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids)
|
|
for a list of registered protocol IDs.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="198"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20448">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="protocols" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20449">a %NULL-terminated
|
|
array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_certificate" c:identifier="g_dtls_connection_set_certificate" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20467">This sets the certificate that @conn will present to its peer
|
|
during the TLS handshake. For a #GDtlsServerConnection, it is
|
|
mandatory to set this, and that will normally be done at construct
|
|
time.
|
|
|
|
For a #GDtlsClientConnection, this is optional. If a handshake fails
|
|
with %G_TLS_ERROR_CERTIFICATE_REQUIRED, that means that the server
|
|
requires a certificate, and if you try connecting again, you should
|
|
call this method first. You can call
|
|
g_dtls_client_connection_get_accepted_cas() on the failed connection
|
|
to get a list of Certificate Authorities that the server will
|
|
accept certificates from.
|
|
|
|
(It is also possible that a server will allow the connection with
|
|
or without a certificate; in that case, if you don't provide a
|
|
certificate, you can tell that the server requested one by the fact
|
|
that g_dtls_client_connection_get_accepted_cas() will return
|
|
non-%NULL.)</doc>
|
|
<source-position filename="gdtlsconnection.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20469">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20470">the certificate to use for @conn</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_database" c:identifier="g_dtls_connection_set_database" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20495">Sets the certificate database that is used to verify peer certificates.
|
|
This is set to the default database by default. See
|
|
g_tls_backend_get_default_database(). If set to %NULL, then
|
|
peer certificate validation will always set the
|
|
%G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
|
|
#GDtlsConnection::accept-certificate will always be emitted on
|
|
client-side connections, unless that bit is not set in
|
|
#GDtlsClientConnection:validation-flags).</doc>
|
|
<source-position filename="gdtlsconnection.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20497">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="database" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20498">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_interaction" c:identifier="g_dtls_connection_set_interaction" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20513">Set the object that will be used to interact with the user. It will be used
|
|
for things like prompting the user for passwords.
|
|
|
|
The @interaction argument will normally be a derived subclass of
|
|
#GTlsInteraction. %NULL can also be provided if no user interaction
|
|
should occur for this connection.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20515">a connection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20516">an interaction object, or %NULL</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_rehandshake_mode" c:identifier="g_dtls_connection_set_rehandshake_mode" version="2.48" deprecated="1" deprecated-version="2.60.">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20529">Sets how @conn behaves with respect to rehandshaking requests.
|
|
|
|
%G_TLS_REHANDSHAKE_NEVER means that it will never agree to
|
|
rehandshake after the initial handshake is complete. (For a client,
|
|
this means it will refuse rehandshake requests from the server, and
|
|
for a server, this means it will close the connection with an error
|
|
if the client attempts to rehandshake.)
|
|
|
|
%G_TLS_REHANDSHAKE_SAFELY means that the connection will allow a
|
|
rehandshake only if the other end of the connection supports the
|
|
TLS `renegotiation_info` extension. This is the default behavior,
|
|
but means that rehandshaking will not work against older
|
|
implementations that do not support that extension.
|
|
|
|
%G_TLS_REHANDSHAKE_UNSAFELY means that the connection will allow
|
|
rehandshaking even without the `renegotiation_info` extension. On
|
|
the server side in particular, this is not recommended, since it
|
|
leaves the server open to certain attacks. However, this mode is
|
|
necessary if you need to allow renegotiation with older client
|
|
software.</doc>
|
|
<doc-deprecated xml:space="preserve">Changing the rehandshake mode is no longer
|
|
required for compatibility. Also, rehandshaking has been removed
|
|
from the TLS protocol in TLS 1.3.</doc-deprecated>
|
|
<source-position filename="gdtlsconnection.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20531">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="mode" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20532">the rehandshaking mode</doc>
|
|
<type name="TlsRehandshakeMode" c:type="GTlsRehandshakeMode"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_require_close_notify" c:identifier="g_dtls_connection_set_require_close_notify" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20562">Sets whether or not @conn expects a proper TLS close notification
|
|
before the connection is closed. If this is %TRUE (the default),
|
|
then @conn will expect to receive a TLS close notification from its
|
|
peer before the connection is closed, and will return a
|
|
%G_TLS_ERROR_EOF error if the connection is closed without proper
|
|
notification (since this may indicate a network error, or
|
|
man-in-the-middle attack).
|
|
|
|
In some protocols, the application will know whether or not the
|
|
connection was closed cleanly based on application-level data
|
|
(because the application-level data includes a length field, or is
|
|
somehow self-delimiting); in this case, the close notify is
|
|
redundant and may be omitted. You
|
|
can use g_dtls_connection_set_require_close_notify() to tell @conn
|
|
to allow an "unannounced" connection close, in which case the close
|
|
will show up as a 0-length read, as in a non-TLS
|
|
#GDatagramBased, and it is up to the application to check that
|
|
the data has been fully received.
|
|
|
|
Note that this only affects the behavior when the peer closes the
|
|
connection; when the application calls g_dtls_connection_close_async() on
|
|
@conn itself, this will send a close notification regardless of the
|
|
setting of this property. If you explicitly want to do an unclean
|
|
close, you can close @conn's #GDtlsConnection:base-socket rather
|
|
than closing @conn itself.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="127"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20564">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="require_close_notify" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20565">whether or not to require close notification</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="shutdown" c:identifier="g_dtls_connection_shutdown" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20597">Shut down part or all of a DTLS connection.
|
|
|
|
If @shutdown_read is %TRUE then the receiving side of the connection is shut
|
|
down, and further reading is disallowed. Subsequent calls to
|
|
g_datagram_based_receive_messages() will return %G_IO_ERROR_CLOSED.
|
|
|
|
If @shutdown_write is %TRUE then the sending side of the connection is shut
|
|
down, and further writing is disallowed. Subsequent calls to
|
|
g_datagram_based_send_messages() will return %G_IO_ERROR_CLOSED.
|
|
|
|
It is allowed for both @shutdown_read and @shutdown_write to be TRUE — this
|
|
is equivalent to calling g_dtls_connection_close().
|
|
|
|
If @cancellable is cancelled, the #GDtlsConnection may be left
|
|
partially-closed and any pending untransmitted data may be lost. Call
|
|
g_dtls_connection_shutdown() again to complete closing the #GDtlsConnection.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="157"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20622">%TRUE on success, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20599">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="shutdown_read" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20600">%TRUE to stop reception of incoming datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="shutdown_write" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20601">%TRUE to stop sending outgoing datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20602">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="shutdown_async" c:identifier="g_dtls_connection_shutdown_async" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20627">Asynchronously shut down part or all of the DTLS connection. See
|
|
g_dtls_connection_shutdown() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="164"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20629">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="shutdown_read" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20630">%TRUE to stop reception of incoming datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="shutdown_write" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20631">%TRUE to stop sending outgoing datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20632">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20633">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20634">callback to call when the shutdown operation is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20635">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="shutdown_finish" c:identifier="g_dtls_connection_shutdown_finish" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20644">Finish an asynchronous TLS shutdown operation. See
|
|
g_dtls_connection_shutdown() for more information.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="172"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20653">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20646">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20647">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="advertised-protocols" version="2.60" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1651">The list of application-layer protocols that the connection
|
|
advertises that it is willing to speak. See
|
|
g_dtls_connection_set_advertised_protocols().</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</property>
|
|
<property name="base-socket" version="2.48" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1662">The #GDatagramBased that the connection wraps. Note that this may be any
|
|
implementation of #GDatagramBased, not just a #GSocket.</doc>
|
|
<type name="DatagramBased"/>
|
|
</property>
|
|
<property name="certificate" version="2.48" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1672">The connection's certificate; see
|
|
g_dtls_connection_set_certificate().</doc>
|
|
<type name="TlsCertificate"/>
|
|
</property>
|
|
<property name="database" version="2.48" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1682">The certificate database to use when verifying this TLS connection.
|
|
If no certificate database is set, then the default database will be
|
|
used. See g_tls_backend_get_default_database().</doc>
|
|
<type name="TlsDatabase"/>
|
|
</property>
|
|
<property name="interaction" version="2.48" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1693">A #GTlsInteraction object to be used when the connection or certificate
|
|
database need to interact with the user. This will be used to prompt the
|
|
user for passwords where necessary.</doc>
|
|
<type name="TlsInteraction"/>
|
|
</property>
|
|
<property name="negotiated-protocol" version="2.60" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1704">The application-layer protocol negotiated during the TLS
|
|
handshake. See g_dtls_connection_get_negotiated_protocol().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="peer-certificate" version="2.48" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1714">The connection's peer's certificate, after the TLS handshake has
|
|
completed and the certificate has been accepted. Note in
|
|
particular that this is not yet set during the emission of
|
|
#GDtlsConnection::accept-certificate.
|
|
|
|
(You can watch for a #GObject::notify signal on this property to
|
|
detect when a handshake has occurred.)</doc>
|
|
<type name="TlsCertificate"/>
|
|
</property>
|
|
<property name="peer-certificate-errors" version="2.48" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1729">The errors noticed-and-ignored while verifying
|
|
#GDtlsConnection:peer-certificate. Normally this should be 0, but
|
|
it may not be if #GDtlsClientConnection:validation-flags is not
|
|
%G_TLS_CERTIFICATE_VALIDATE_ALL, or if
|
|
#GDtlsConnection::accept-certificate overrode the default
|
|
behavior.</doc>
|
|
<type name="TlsCertificateFlags"/>
|
|
</property>
|
|
<property name="rehandshake-mode" version="2.48" deprecated="1" deprecated-version="2.60." writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1743">The rehandshaking mode. See
|
|
g_dtls_connection_set_rehandshake_mode().</doc>
|
|
<doc-deprecated xml:space="preserve">Changing the rehandshake mode is no longer
|
|
required for compatibility. Also, rehandshaking has been removed
|
|
from the TLS protocol in TLS 1.3.</doc-deprecated>
|
|
<type name="TlsRehandshakeMode"/>
|
|
</property>
|
|
<property name="require-close-notify" version="2.48" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1756">Whether or not proper TLS close notification is required.
|
|
See g_dtls_connection_set_require_close_notify().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<glib:signal name="accept-certificate" when="last" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1603">Emitted during the TLS handshake after the peer certificate has
|
|
been received. You can examine @peer_cert's certification path by
|
|
calling g_tls_certificate_get_issuer() on it.
|
|
|
|
For a client-side connection, @peer_cert is the server's
|
|
certificate, and the signal will only be emitted if the
|
|
certificate was not acceptable according to @conn's
|
|
#GDtlsClientConnection:validation_flags. If you would like the
|
|
certificate to be accepted despite @errors, return %TRUE from the
|
|
signal handler. Otherwise, if no handler accepts the certificate,
|
|
the handshake will fail with %G_TLS_ERROR_BAD_CERTIFICATE.
|
|
|
|
For a server-side connection, @peer_cert is the certificate
|
|
presented by the client, if this was requested via the server's
|
|
#GDtlsServerConnection:authentication_mode. On the server side,
|
|
the signal is always emitted when the client presents a
|
|
certificate, and the certificate will only be accepted if a
|
|
handler returns %TRUE.
|
|
|
|
Note that if this signal is emitted as part of asynchronous I/O
|
|
in the main thread, then you should not attempt to interact with
|
|
the user before returning from the signal handler. If you want to
|
|
let the user decide whether or not to accept the certificate, you
|
|
would have to return %FALSE from the signal handler on the first
|
|
attempt, and then after the connection attempt returns a
|
|
%G_TLS_ERROR_BAD_CERTIFICATE, you can interact with the user, and
|
|
if the user decides to accept the certificate, remember that fact,
|
|
create a new connection, and return %TRUE from the signal handler
|
|
the next time.
|
|
|
|
If you are doing I/O in another thread, you do not
|
|
need to worry about this, and can simply block in the signal
|
|
handler until the UI thread returns an answer.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1643">%TRUE to accept @peer_cert (which will also
|
|
immediately end the signal emission). %FALSE to allow the signal
|
|
emission to continue, which will cause the handshake to fail if
|
|
no one else overrides it.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1606">the peer's #GTlsCertificate</doc>
|
|
<type name="TlsCertificate"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1607">the problems with @peer_cert.</doc>
|
|
<type name="TlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="DtlsConnectionInterface" c:type="GDtlsConnectionInterface" glib:is-gtype-struct-for="DtlsConnection" version="2.48">
|
|
<doc xml:space="preserve" filename="gdtlsconnection.h" line="38">Virtual method table for a #GDtlsConnection implementation.</doc>
|
|
<source-position filename="gdtlsconnection.h" line="98"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gdtlsconnection.h" line="40">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="accept_certificate">
|
|
<callback name="accept_certificate">
|
|
<source-position filename="gdtlsconnection.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handshake">
|
|
<callback name="handshake" throws="1">
|
|
<source-position filename="gdtlsconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20411">success or failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20377">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20378">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handshake_async">
|
|
<callback name="handshake_async">
|
|
<source-position filename="gdtlsconnection.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20418">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20419">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20420">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20421">callback to call when the handshake is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20422">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handshake_finish">
|
|
<callback name="handshake_finish" throws="1">
|
|
<source-position filename="gdtlsconnection.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20440">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20433">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20434">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="shutdown">
|
|
<callback name="shutdown" throws="1">
|
|
<source-position filename="gdtlsconnection.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20622">%TRUE on success, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20599">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="shutdown_read" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20600">%TRUE to stop reception of incoming datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="shutdown_write" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20601">%TRUE to stop sending outgoing datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20602">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="shutdown_async">
|
|
<callback name="shutdown_async">
|
|
<source-position filename="gdtlsconnection.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20629">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="shutdown_read" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20630">%TRUE to stop reception of incoming datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="shutdown_write" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20631">%TRUE to stop sending outgoing datagrams</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20632">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20633">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20634">callback to call when the shutdown operation is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20635">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="shutdown_finish">
|
|
<callback name="shutdown_finish" throws="1">
|
|
<source-position filename="gdtlsconnection.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20653">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20646">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20647">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_advertised_protocols">
|
|
<callback name="set_advertised_protocols">
|
|
<source-position filename="gdtlsconnection.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20448">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="protocols" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20449">a %NULL-terminated
|
|
array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_negotiated_protocol">
|
|
<callback name="get_negotiated_protocol">
|
|
<source-position filename="gdtlsconnection.h" line="97"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20319">the negotiated protocol, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20309">a #GDtlsConnection</doc>
|
|
<type name="DtlsConnection" c:type="GDtlsConnection*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<interface name="DtlsServerConnection" c:symbol-prefix="dtls_server_connection" c:type="GDtlsServerConnection" version="2.48" glib:type-name="GDtlsServerConnection" glib:get-type="g_dtls_server_connection_get_type" glib:type-struct="DtlsServerConnectionInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6092">#GDtlsServerConnection is the server-side subclass of #GDtlsConnection,
|
|
representing a server-side DTLS connection.</doc>
|
|
<source-position filename="gdtlsserverconnection.h" line="57"/>
|
|
<prerequisite name="DatagramBased"/>
|
|
<prerequisite name="DtlsConnection"/>
|
|
<function name="new" c:identifier="g_dtls_server_connection_new" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20659">Creates a new #GDtlsServerConnection wrapping @base_socket.</doc>
|
|
<source-position filename="gdtlsserverconnection.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20667">the new
|
|
#GDtlsServerConnection, or %NULL on error</doc>
|
|
<type name="DtlsServerConnection" c:type="GDatagramBased*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20661">the #GDatagramBased to wrap</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="certificate" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20662">the default server certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<property name="authentication-mode" version="2.48" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1766">The #GTlsAuthenticationMode for the server. This can be changed
|
|
before calling g_dtls_connection_handshake() if you want to
|
|
rehandshake with a different mode from the initial handshake.</doc>
|
|
<type name="TlsAuthenticationMode"/>
|
|
</property>
|
|
</interface>
|
|
<record name="DtlsServerConnectionInterface" c:type="GDtlsServerConnectionInterface" glib:is-gtype-struct-for="DtlsServerConnection" version="2.48">
|
|
<doc xml:space="preserve" filename="gdtlsserverconnection.h" line="46">vtable for a #GDtlsServerConnection implementation.</doc>
|
|
<source-position filename="gdtlsserverconnection.h" line="57"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gdtlsserverconnection.h" line="48">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
</record>
|
|
<function-macro name="EMBLEM" c:identifier="G_EMBLEM" introspectable="0">
|
|
<source-position filename="gemblem.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="EMBLEMED_ICON" c:identifier="G_EMBLEMED_ICON" introspectable="0">
|
|
<source-position filename="gemblemedicon.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="EMBLEMED_ICON_CLASS" c:identifier="G_EMBLEMED_ICON_CLASS" introspectable="0">
|
|
<source-position filename="gemblemedicon.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="EMBLEMED_ICON_GET_CLASS" c:identifier="G_EMBLEMED_ICON_GET_CLASS" introspectable="0">
|
|
<source-position filename="gemblemedicon.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="EMBLEM_CLASS" c:identifier="G_EMBLEM_CLASS" introspectable="0">
|
|
<source-position filename="gemblem.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="EMBLEM_GET_CLASS" c:identifier="G_EMBLEM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gemblem.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="Emblem" c:symbol-prefix="emblem" c:type="GEmblem" parent="GObject.Object" glib:type-name="GEmblem" glib:get-type="g_emblem_get_type" glib:type-struct="EmblemClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6104">#GEmblem is an implementation of #GIcon that supports
|
|
having an emblem, which is an icon with additional properties.
|
|
It can than be added to a #GEmblemedIcon.
|
|
|
|
Currently, only metainformation about the emblem's origin is
|
|
supported. More may be added in the future.</doc>
|
|
<source-position filename="gemblem.h" line="44"/>
|
|
<implements name="Icon"/>
|
|
<constructor name="new" c:identifier="g_emblem_new" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20696">Creates a new emblem for @icon.</doc>
|
|
<source-position filename="gemblem.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20702">a new #GEmblem.</doc>
|
|
<type name="Emblem" c:type="GEmblem*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20698">a GIcon containing the icon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_with_origin" c:identifier="g_emblem_new_with_origin" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20707">Creates a new emblem for @icon.</doc>
|
|
<source-position filename="gemblem.h" line="52"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20714">a new #GEmblem.</doc>
|
|
<type name="Emblem" c:type="GEmblem*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20709">a GIcon containing the icon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
<parameter name="origin" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20710">a GEmblemOrigin enum defining the emblem's origin</doc>
|
|
<type name="EmblemOrigin" c:type="GEmblemOrigin"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_icon" c:identifier="g_emblem_get_icon" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20673">Gives back the icon from @emblem.</doc>
|
|
<source-position filename="gemblem.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20679">a #GIcon. The returned object belongs to
|
|
the emblem and should not be modified or freed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="emblem" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20675">a #GEmblem from which the icon should be extracted.</doc>
|
|
<type name="Emblem" c:type="GEmblem*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_origin" c:identifier="g_emblem_get_origin" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20685">Gets the origin of the emblem.</doc>
|
|
<source-position filename="gemblem.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20691">the origin of the emblem</doc>
|
|
<type name="EmblemOrigin" c:type="GEmblemOrigin"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="emblem" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20687">a #GEmblem</doc>
|
|
<type name="Emblem" c:type="GEmblem*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="icon" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="GObject.Object"/>
|
|
</property>
|
|
<property name="origin" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="EmblemOrigin"/>
|
|
</property>
|
|
</class>
|
|
<record name="EmblemClass" c:type="GEmblemClass" disguised="1" glib:is-gtype-struct-for="Emblem">
|
|
<source-position filename="gemblem.h" line="44"/>
|
|
</record>
|
|
<enumeration name="EmblemOrigin" version="2.18" glib:type-name="GEmblemOrigin" glib:get-type="g_emblem_origin_get_type" c:type="GEmblemOrigin">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="678">GEmblemOrigin is used to add information about the origin of the emblem
|
|
to #GEmblem.</doc>
|
|
<member name="unknown" value="0" c:identifier="G_EMBLEM_ORIGIN_UNKNOWN" glib:nick="unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="680">Emblem of unknown origin</doc>
|
|
</member>
|
|
<member name="device" value="1" c:identifier="G_EMBLEM_ORIGIN_DEVICE" glib:nick="device">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="681">Emblem adds device-specific information</doc>
|
|
</member>
|
|
<member name="livemetadata" value="2" c:identifier="G_EMBLEM_ORIGIN_LIVEMETADATA" glib:nick="livemetadata">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="682">Emblem depicts live metadata, such as "readonly"</doc>
|
|
</member>
|
|
<member name="tag" value="3" c:identifier="G_EMBLEM_ORIGIN_TAG" glib:nick="tag">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="683">Emblem comes from a user-defined tag, e.g. set by nautilus (in the future)</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="EmblemedIcon" c:symbol-prefix="emblemed_icon" c:type="GEmblemedIcon" parent="GObject.Object" glib:type-name="GEmblemedIcon" glib:get-type="g_emblemed_icon_get_type" glib:type-struct="EmblemedIconClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6119">#GEmblemedIcon is an implementation of #GIcon that supports
|
|
adding an emblem to an icon. Adding multiple emblems to an
|
|
icon is ensured via g_emblemed_icon_add_emblem().
|
|
|
|
Note that #GEmblemedIcon allows no control over the position
|
|
of the emblems. See also #GEmblem for more information.</doc>
|
|
<source-position filename="gemblemedicon.h" line="61"/>
|
|
<implements name="Icon"/>
|
|
<constructor name="new" c:identifier="g_emblemed_icon_new" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20763">Creates a new emblemed icon for @icon with the emblem @emblem.</doc>
|
|
<source-position filename="gemblemedicon.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20770">a new #GIcon</doc>
|
|
<type name="EmblemedIcon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20765">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
<parameter name="emblem" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20766">a #GEmblem, or %NULL</doc>
|
|
<type name="Emblem" c:type="GEmblem*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="add_emblem" c:identifier="g_emblemed_icon_add_emblem" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20719">Adds @emblem to the #GList of #GEmblems.</doc>
|
|
<source-position filename="gemblemedicon.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="emblemed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20721">a #GEmblemedIcon</doc>
|
|
<type name="EmblemedIcon" c:type="GEmblemedIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="emblem" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20722">a #GEmblem</doc>
|
|
<type name="Emblem" c:type="GEmblem*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="clear_emblems" c:identifier="g_emblemed_icon_clear_emblems" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20730">Removes all the emblems from @icon.</doc>
|
|
<source-position filename="gemblemedicon.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="emblemed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20732">a #GEmblemedIcon</doc>
|
|
<type name="EmblemedIcon" c:type="GEmblemedIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_emblems" c:identifier="g_emblemed_icon_get_emblems" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20740">Gets the list of emblems for the @icon.</doc>
|
|
<source-position filename="gemblemedicon.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20746">a #GList of
|
|
#GEmblems that is owned by @emblemed</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Emblem"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="emblemed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20742">a #GEmblemedIcon</doc>
|
|
<type name="EmblemedIcon" c:type="GEmblemedIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_icon" c:identifier="g_emblemed_icon_get_icon" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20752">Gets the main icon for @emblemed.</doc>
|
|
<source-position filename="gemblemedicon.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20758">a #GIcon that is owned by @emblemed</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="emblemed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20754">a #GEmblemedIcon</doc>
|
|
<type name="EmblemedIcon" c:type="GEmblemedIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="gicon" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="Icon"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="EmblemedIconPrivate" c:type="GEmblemedIconPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="EmblemedIconClass" c:type="GEmblemedIconClass" glib:is-gtype-struct-for="EmblemedIcon">
|
|
<source-position filename="gemblemedicon.h" line="61"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="EmblemedIconPrivate" c:type="GEmblemedIconPrivate" disguised="1">
|
|
<source-position filename="gemblemedicon.h" line="48"/>
|
|
</record>
|
|
<function-macro name="FILE" c:identifier="G_FILE" introspectable="0">
|
|
<source-position filename="gfile.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILENAME_COMPLETER" c:identifier="G_FILENAME_COMPLETER" introspectable="0">
|
|
<source-position filename="gfilenamecompleter.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILENAME_COMPLETER_CLASS" c:identifier="G_FILENAME_COMPLETER_CLASS" introspectable="0">
|
|
<source-position filename="gfilenamecompleter.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILENAME_COMPLETER_GET_CLASS" c:identifier="G_FILENAME_COMPLETER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfilenamecompleter.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="FILE_ATTRIBUTE_ACCESS_CAN_DELETE" value="access::can-delete" c:type="G_FILE_ATTRIBUTE_ACCESS_CAN_DELETE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="326">A key in the "access" namespace for checking deletion privileges.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
This attribute will be %TRUE if the user is able to delete the file.</doc>
|
|
<source-position filename="gfileinfo.h" line="333"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE" value="access::can-execute" c:type="G_FILE_ATTRIBUTE_ACCESS_CAN_EXECUTE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="317">A key in the "access" namespace for getting execution privileges.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
This attribute will be %TRUE if the user is able to execute the file.</doc>
|
|
<source-position filename="gfileinfo.h" line="324"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ACCESS_CAN_READ" value="access::can-read" c:type="G_FILE_ATTRIBUTE_ACCESS_CAN_READ">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="299">A key in the "access" namespace for getting read privileges.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
This attribute will be %TRUE if the user is able to read the file.</doc>
|
|
<source-position filename="gfileinfo.h" line="306"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ACCESS_CAN_RENAME" value="access::can-rename" c:type="G_FILE_ATTRIBUTE_ACCESS_CAN_RENAME">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="345">A key in the "access" namespace for checking renaming privileges.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
This attribute will be %TRUE if the user is able to rename the file.</doc>
|
|
<source-position filename="gfileinfo.h" line="352"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ACCESS_CAN_TRASH" value="access::can-trash" c:type="G_FILE_ATTRIBUTE_ACCESS_CAN_TRASH">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="335">A key in the "access" namespace for checking trashing privileges.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
This attribute will be %TRUE if the user is able to move the file to
|
|
the trash.</doc>
|
|
<source-position filename="gfileinfo.h" line="343"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ACCESS_CAN_WRITE" value="access::can-write" c:type="G_FILE_ATTRIBUTE_ACCESS_CAN_WRITE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="308">A key in the "access" namespace for getting write privileges.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.
|
|
This attribute will be %TRUE if the user is able to write to the file.</doc>
|
|
<source-position filename="gfileinfo.h" line="315"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_DOS_IS_ARCHIVE" value="dos::is-archive" c:type="G_FILE_ATTRIBUTE_DOS_IS_ARCHIVE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="656">A key in the "dos" namespace for checking if the file's archive flag
|
|
is set. This attribute is %TRUE if the archive flag is set. This attribute
|
|
is only available for DOS file systems. Corresponding #GFileAttributeType
|
|
is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="664"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT" value="dos::is-mountpoint" c:type="G_FILE_ATTRIBUTE_DOS_IS_MOUNTPOINT" version="2.60">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="676">A key in the "dos" namespace for checking if the file is a NTFS mount point
|
|
(a volume mount or a junction point).
|
|
This attribute is %TRUE if file is a reparse point of type
|
|
[IO_REPARSE_TAG_MOUNT_POINT](https://msdn.microsoft.com/en-us/library/dd541667.aspx).
|
|
This attribute is only available for DOS file systems.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="688"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_DOS_IS_SYSTEM" value="dos::is-system" c:type="G_FILE_ATTRIBUTE_DOS_IS_SYSTEM">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="666">A key in the "dos" namespace for checking if the file's backup flag
|
|
is set. This attribute is %TRUE if the backup flag is set. This attribute
|
|
is only available for DOS file systems. Corresponding #GFileAttributeType
|
|
is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="674"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG" value="dos::reparse-point-tag" c:type="G_FILE_ATTRIBUTE_DOS_REPARSE_POINT_TAG" version="2.60">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="690">A key in the "dos" namespace for getting the file NTFS reparse tag.
|
|
This value is 0 for files that are not reparse points.
|
|
See the [Reparse Tags](https://msdn.microsoft.com/en-us/library/dd541667.aspx)
|
|
page for possible reparse tag values. Corresponding #GFileAttributeType
|
|
is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="701"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ETAG_VALUE" value="etag::value" c:type="G_FILE_ATTRIBUTE_ETAG_VALUE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="263">A key in the "etag" namespace for getting the value of the file's
|
|
entity tag. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="270"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_FILESYSTEM_FREE" value="filesystem::free" c:type="G_FILE_ATTRIBUTE_FILESYSTEM_FREE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="791">A key in the "filesystem" namespace for getting the number of bytes of free space left on the
|
|
file system. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="798"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_FILESYSTEM_READONLY" value="filesystem::readonly" c:type="G_FILE_ATTRIBUTE_FILESYSTEM_READONLY">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="819">A key in the "filesystem" namespace for checking if the file system
|
|
is read only. Is set to %TRUE if the file system is read only.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="826"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_FILESYSTEM_REMOTE" value="filesystem::remote" c:type="G_FILE_ATTRIBUTE_FILESYSTEM_REMOTE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="838">A key in the "filesystem" namespace for checking if the file system
|
|
is remote. Is set to %TRUE if the file system is remote.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="845"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_FILESYSTEM_SIZE" value="filesystem::size" c:type="G_FILE_ATTRIBUTE_FILESYSTEM_SIZE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="782">A key in the "filesystem" namespace for getting the total size (in bytes) of the file system,
|
|
used in g_file_query_filesystem_info(). Corresponding #GFileAttributeType
|
|
is %G_FILE_ATTRIBUTE_TYPE_UINT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="789"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_FILESYSTEM_TYPE" value="filesystem::type" c:type="G_FILE_ATTRIBUTE_FILESYSTEM_TYPE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="811">A key in the "filesystem" namespace for getting the file system's type.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="817"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_FILESYSTEM_USED" value="filesystem::used" c:type="G_FILE_ATTRIBUTE_FILESYSTEM_USED" version="2.32">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="800">A key in the "filesystem" namespace for getting the number of bytes of used on the
|
|
file system. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="809"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW" value="filesystem::use-preview" c:type="G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="828">A key in the "filesystem" namespace for hinting a file manager
|
|
application whether it should preview (e.g. thumbnail) files on the
|
|
file system. The value for this key contain a
|
|
#GFilesystemPreviewType.</doc>
|
|
<source-position filename="gfileinfo.h" line="836"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_GVFS_BACKEND" value="gvfs::backend" c:type="G_FILE_ATTRIBUTE_GVFS_BACKEND">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="847">A key in the "gvfs" namespace that gets the name of the current
|
|
GVFS backend in use. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="854"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ID_FILE" value="id::file" c:type="G_FILE_ATTRIBUTE_ID_FILE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="276">A key in the "id" namespace for getting a file identifier.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
An example use would be during listing files, to avoid recursive
|
|
directory scanning.</doc>
|
|
<source-position filename="gfileinfo.h" line="284"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_ID_FILESYSTEM" value="id::filesystem" c:type="G_FILE_ATTRIBUTE_ID_FILESYSTEM">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="286">A key in the "id" namespace for getting the file system identifier.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
An example use would be during drag and drop to see if the source
|
|
and target are on the same filesystem (default to move) or not (default
|
|
to copy).</doc>
|
|
<source-position filename="gfileinfo.h" line="295"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT" value="mountable::can-eject" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_EJECT">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="374">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be ejected.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="380"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT" value="mountable::can-mount" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_MOUNT">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="358">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is mountable.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="364"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL" value="mountable::can-poll" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_POLL" version="2.22">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="449">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be polled.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="457"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_START" value="mountable::can-start" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START" version="2.22">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="408">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="416"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED" value="mountable::can-start-degraded" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_START_DEGRADED" version="2.22">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="418">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be started
|
|
degraded.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="427"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP" value="mountable::can-stop" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_STOP" version="2.22">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="429">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) can be stopped.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="437"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT" value="mountable::can-unmount" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_CAN_UNMOUNT">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="366">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE) is unmountable.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="372"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI" value="mountable::hal-udi" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_HAL_UDI">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="400">A key in the "mountable" namespace for getting the HAL UDI for the mountable
|
|
file. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="406"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC" value="mountable::is-media-check-automatic" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_IS_MEDIA_CHECK_AUTOMATIC" version="2.22">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="459">A key in the "mountable" namespace for checking if a file (of type G_FILE_TYPE_MOUNTABLE)
|
|
is automatically polled for media.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="468"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE" value="mountable::start-stop-type" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_START_STOP_TYPE" version="2.22">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="439">A key in the "mountable" namespace for getting the #GDriveStartStopType.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="447"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE" value="mountable::unix-device" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="382">A key in the "mountable" namespace for getting the unix device.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="388"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE" value="mountable::unix-device-file" c:type="G_FILE_ATTRIBUTE_MOUNTABLE_UNIX_DEVICE_FILE" version="2.22">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="390">A key in the "mountable" namespace for getting the unix device file.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="398"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_OWNER_GROUP" value="owner::group" c:type="G_FILE_ATTRIBUTE_OWNER_GROUP">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="723">A key in the "owner" namespace for getting the file owner's group.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="729"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_OWNER_USER" value="owner::user" c:type="G_FILE_ATTRIBUTE_OWNER_USER">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="705">A key in the "owner" namespace for getting the user name of the
|
|
file's owner. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="712"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_OWNER_USER_REAL" value="owner::user-real" c:type="G_FILE_ATTRIBUTE_OWNER_USER_REAL">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="714">A key in the "owner" namespace for getting the real name of the
|
|
user that owns the file. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="721"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_PREVIEW_ICON" value="preview::icon" c:type="G_FILE_ATTRIBUTE_PREVIEW_ICON" version="2.20">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="767">A key in the "preview" namespace for getting a #GIcon that can be
|
|
used to get preview of the file. For example, it may be a low
|
|
resolution thumbnail without metadata. Corresponding
|
|
#GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT. The value
|
|
for this key should contain a #GIcon.</doc>
|
|
<source-position filename="gfileinfo.h" line="778"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_RECENT_MODIFIED" value="recent::modified" c:type="G_FILE_ATTRIBUTE_RECENT_MODIFIED" version="2.52">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="899">A key in the "recent" namespace for getting time, when the metadata for the
|
|
file in `recent:///` was last changed. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_INT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="908"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_SELINUX_CONTEXT" value="selinux::context" c:type="G_FILE_ATTRIBUTE_SELINUX_CONTEXT">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="856">A key in the "selinux" namespace for getting the file's SELinux
|
|
context. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_STRING. Note that this attribute is only
|
|
available if GLib has been built with SELinux support.</doc>
|
|
<source-position filename="gfileinfo.h" line="864"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE" value="standard::allocated-size" c:type="G_FILE_ATTRIBUTE_STANDARD_ALLOCATED_SIZE" version="2.20">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="218">A key in the "standard" namespace for getting the amount of disk space
|
|
that is consumed by the file (in bytes). This will generally be larger
|
|
than the file size (due to block size overhead) but can occasionally be
|
|
smaller (for example, for sparse files).
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="229"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE" value="standard::content-type" c:type="G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="189">A key in the "standard" namespace for getting the content type of the file.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.
|
|
The value for this key should contain a valid content type.</doc>
|
|
<source-position filename="gfileinfo.h" line="196"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_COPY_NAME" value="standard::copy-name" c:type="G_FILE_ATTRIBUTE_STANDARD_COPY_NAME">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="141">A key in the "standard" namespace for getting the copy name of the file.
|
|
The copy name is an optional version of the name. If available it's always
|
|
in UTF8, and corresponds directly to the original filename (only transcoded to
|
|
UTF8). This is useful if you want to copy the file to another filesystem that
|
|
might have a different encoding. If the filename is not a valid string in the
|
|
encoding selected for the filesystem it is in then the copy name will not be set.
|
|
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="153"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_DESCRIPTION" value="standard::description" c:type="G_FILE_ATTRIBUTE_STANDARD_DESCRIPTION">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="155">A key in the "standard" namespace for getting the description of the file.
|
|
The description is a utf8 string that describes the file, generally containing
|
|
the filename, but can also contain furter information. Example descriptions
|
|
could be "filename (on hostname)" for a remote file or "filename (in trash)"
|
|
for a file in the trash. This is useful for instance as the window title
|
|
when displaying a directory or for a bookmarks menu.
|
|
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="167"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME" value="standard::display-name" c:type="G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="118">A key in the "standard" namespace for getting the display name of the file.
|
|
A display name is guaranteed to be in UTF8 and can thus be displayed in
|
|
the UI.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="126"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_EDIT_NAME" value="standard::edit-name" c:type="G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="128">A key in the "standard" namespace for edit name of the file.
|
|
An edit name is similar to the display name, but it is meant to be
|
|
used when you want to rename the file in the UI. The display name
|
|
might contain information you don't want in the new filename (such as
|
|
"(invalid unicode)" if the filename was in an invalid encoding).
|
|
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="139"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE" value="standard::fast-content-type" c:type="G_FILE_ATTRIBUTE_STANDARD_FAST_CONTENT_TYPE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="198">A key in the "standard" namespace for getting the fast content type.
|
|
The fast content type isn't as reliable as the regular one, as it
|
|
only uses the filename to guess it, but it is faster to calculate than the
|
|
regular content type.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="208"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_ICON" value="standard::icon" c:type="G_FILE_ATTRIBUTE_STANDARD_ICON">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="169">A key in the "standard" namespace for getting the icon for the file.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
|
|
The value for this key should contain a #GIcon.</doc>
|
|
<source-position filename="gfileinfo.h" line="176"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_IS_BACKUP" value="standard::is-backup" c:type="G_FILE_ATTRIBUTE_STANDARD_IS_BACKUP">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="65">A key in the "standard" namespace for checking if a file is a backup file.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="71"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_IS_HIDDEN" value="standard::is-hidden" c:type="G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="57">A key in the "standard" namespace for checking if a file is hidden.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="63"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_IS_SYMLINK" value="standard::is-symlink" c:type="G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="73">A key in the "standard" namespace for checking if the file is a symlink.
|
|
Typically the actual type is something else, if we followed the symlink
|
|
to get the type.
|
|
On Windows NTFS mountpoints are considered to be symlinks as well.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="82"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL" value="standard::is-virtual" c:type="G_FILE_ATTRIBUTE_STANDARD_IS_VIRTUAL">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="84">A key in the "standard" namespace for checking if a file is virtual.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="90"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_IS_VOLATILE" value="standard::is-volatile" c:type="G_FILE_ATTRIBUTE_STANDARD_IS_VOLATILE" version="2.46">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="92">A key in the "standard" namespace for checking if a file is
|
|
volatile. This is meant for opaque, non-POSIX-like backends to
|
|
indicate that the URI is not persistent. Applications should look
|
|
at #G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI.
|
|
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="104"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_NAME" value="standard::name" c:type="G_FILE_ATTRIBUTE_STANDARD_NAME">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="106">A key in the "standard" namespace for getting the name of the file.
|
|
The name is the on-disk filename which may not be in any known encoding,
|
|
and can thus not be generally displayed as is.
|
|
Use #G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME if you need to display the
|
|
name in a user interface.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="116"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_SIZE" value="standard::size" c:type="G_FILE_ATTRIBUTE_STANDARD_SIZE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="210">A key in the "standard" namespace for getting the file's size (in bytes).
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="216"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_SORT_ORDER" value="standard::sort-order" c:type="G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="249">A key in the "standard" namespace for setting the sort order of a file.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_INT32.
|
|
An example use would be in file managers, which would use this key
|
|
to set the order files are displayed. Files with smaller sort order
|
|
should be sorted first, and files without sort order as if sort order
|
|
was zero.</doc>
|
|
<source-position filename="gfileinfo.h" line="259"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON" value="standard::symbolic-icon" c:type="G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON" version="2.34">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="178">A key in the "standard" namespace for getting the symbolic icon for the file.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_OBJECT.
|
|
The value for this key should contain a #GIcon.</doc>
|
|
<source-position filename="gfileinfo.h" line="187"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET" value="standard::symlink-target" c:type="G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="231">A key in the "standard" namespace for getting the symlink target, if the file
|
|
is a symlink. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="238"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_TARGET_URI" value="standard::target-uri" c:type="G_FILE_ATTRIBUTE_STANDARD_TARGET_URI">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="240">A key in the "standard" namespace for getting the target URI for the file, in
|
|
the case of %G_FILE_TYPE_SHORTCUT or %G_FILE_TYPE_MOUNTABLE files.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="247"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_STANDARD_TYPE" value="standard::type" c:type="G_FILE_ATTRIBUTE_STANDARD_TYPE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="48">A key in the "standard" namespace for storing file types.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.
|
|
The value for this key should contain a #GFileType.</doc>
|
|
<source-position filename="gfileinfo.h" line="55"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_THUMBNAILING_FAILED" value="thumbnail::failed" c:type="G_FILE_ATTRIBUTE_THUMBNAILING_FAILED">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="741">A key in the "thumbnail" namespace for checking if thumbnailing failed.
|
|
This attribute is %TRUE if thumbnailing failed. Corresponding
|
|
#GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="748"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_THUMBNAIL_IS_VALID" value="thumbnail::is-valid" c:type="G_FILE_ATTRIBUTE_THUMBNAIL_IS_VALID" version="2.40">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="749">A key in the "thumbnail" namespace for checking whether the thumbnail is outdated.
|
|
This attribute is %TRUE if the thumbnail is up-to-date with the file it represents,
|
|
and %FALSE if the file has been modified since the thumbnail was generated.
|
|
|
|
If %G_FILE_ATTRIBUTE_THUMBNAILING_FAILED is %TRUE and this attribute is %FALSE,
|
|
it indicates that thumbnailing may be attempted again and may succeed.
|
|
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="763"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_THUMBNAIL_PATH" value="thumbnail::path" c:type="G_FILE_ATTRIBUTE_THUMBNAIL_PATH">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="733">A key in the "thumbnail" namespace for getting the path to the thumbnail
|
|
image. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="740"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_ACCESS" value="time::access" c:type="G_FILE_ATTRIBUTE_TIME_ACCESS">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="492">A key in the "time" namespace for getting the time the file was last
|
|
accessed. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
|
|
file was last accessed, in seconds since the UNIX epoch.</doc>
|
|
<source-position filename="gfileinfo.h" line="500"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_ACCESS_USEC" value="time::access-usec" c:type="G_FILE_ATTRIBUTE_TIME_ACCESS_USEC">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="502">A key in the "time" namespace for getting the microseconds of the time
|
|
the file was last accessed. This should be used in conjunction with
|
|
#G_FILE_ATTRIBUTE_TIME_ACCESS. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="510"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_CHANGED" value="time::changed" c:type="G_FILE_ATTRIBUTE_TIME_CHANGED">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="512">A key in the "time" namespace for getting the time the file was last
|
|
changed. Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
|
|
and contains the time since the file was last changed, in seconds since the
|
|
UNIX epoch.
|
|
|
|
This corresponds to the traditional UNIX ctime.</doc>
|
|
<source-position filename="gfileinfo.h" line="522"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_CHANGED_USEC" value="time::changed-usec" c:type="G_FILE_ATTRIBUTE_TIME_CHANGED_USEC">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="524">A key in the "time" namespace for getting the microseconds of the time
|
|
the file was last changed. This should be used in conjunction with
|
|
#G_FILE_ATTRIBUTE_TIME_CHANGED. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="532"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_CREATED" value="time::created" c:type="G_FILE_ATTRIBUTE_TIME_CREATED">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="534">A key in the "time" namespace for getting the time the file was created.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64,
|
|
and contains the time since the file was created, in seconds since the UNIX
|
|
epoch.
|
|
|
|
This corresponds to the NTFS ctime.</doc>
|
|
<source-position filename="gfileinfo.h" line="544"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_CREATED_USEC" value="time::created-usec" c:type="G_FILE_ATTRIBUTE_TIME_CREATED_USEC">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="546">A key in the "time" namespace for getting the microseconds of the time
|
|
the file was created. This should be used in conjunction with
|
|
#G_FILE_ATTRIBUTE_TIME_CREATED. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="554"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_MODIFIED" value="time::modified" c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="472">A key in the "time" namespace for getting the time the file was last
|
|
modified. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT64, and contains the time since the
|
|
file was modified, in seconds since the UNIX epoch.</doc>
|
|
<source-position filename="gfileinfo.h" line="480"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TIME_MODIFIED_USEC" value="time::modified-usec" c:type="G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="482">A key in the "time" namespace for getting the microseconds of the time
|
|
the file was last modified. This should be used in conjunction with
|
|
#G_FILE_ATTRIBUTE_TIME_MODIFIED. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="490"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TRASH_DELETION_DATE" value="trash::deletion-date" c:type="G_FILE_ATTRIBUTE_TRASH_DELETION_DATE" version="2.24">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="887">A key in the "trash" namespace. When requested against
|
|
items in `trash:///`, will return the date and time when the file
|
|
was trashed. The format of the returned string is YYYY-MM-DDThh:mm:ss.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="897"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TRASH_ITEM_COUNT" value="trash::item-count" c:type="G_FILE_ATTRIBUTE_TRASH_ITEM_COUNT">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="866">A key in the "trash" namespace. When requested against
|
|
`trash:///` returns the number of (toplevel) items in the trash folder.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="873"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_TRASH_ORIG_PATH" value="trash::orig-path" c:type="G_FILE_ATTRIBUTE_TRASH_ORIG_PATH" version="2.24">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="875">A key in the "trash" namespace. When requested against
|
|
items in `trash:///`, will return the original path to the file before it
|
|
was trashed. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_BYTE_STRING.</doc>
|
|
<source-position filename="gfileinfo.h" line="885"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_BLOCKS" value="unix::blocks" c:type="G_FILE_ATTRIBUTE_UNIX_BLOCKS">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="634">A key in the "unix" namespace for getting the number of blocks allocated
|
|
for the file. This attribute is only available for UNIX file systems.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="641"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_BLOCK_SIZE" value="unix::block-size" c:type="G_FILE_ATTRIBUTE_UNIX_BLOCK_SIZE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="625">A key in the "unix" namespace for getting the block size for the file
|
|
system. This attribute is only available for UNIX file systems.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="632"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_DEVICE" value="unix::device" c:type="G_FILE_ATTRIBUTE_UNIX_DEVICE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="558">A key in the "unix" namespace for getting the device id of the device the
|
|
file is located on (see stat() documentation). This attribute is only
|
|
available for UNIX file systems. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="566"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_GID" value="unix::gid" c:type="G_FILE_ATTRIBUTE_UNIX_GID">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="606">A key in the "unix" namespace for getting the group ID for the file.
|
|
This attribute is only available for UNIX file systems.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="613"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_INODE" value="unix::inode" c:type="G_FILE_ATTRIBUTE_UNIX_INODE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="568">A key in the "unix" namespace for getting the inode of the file.
|
|
This attribute is only available for UNIX file systems. Corresponding
|
|
#GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT64.</doc>
|
|
<source-position filename="gfileinfo.h" line="575"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT" value="unix::is-mountpoint" c:type="G_FILE_ATTRIBUTE_UNIX_IS_MOUNTPOINT">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="643">A key in the "unix" namespace for checking if the file represents a
|
|
UNIX mount point. This attribute is %TRUE if the file is a UNIX mount
|
|
point. Since 2.58, `/` is considered to be a mount point.
|
|
This attribute is only available for UNIX file systems.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_BOOLEAN.</doc>
|
|
<source-position filename="gfileinfo.h" line="652"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_MODE" value="unix::mode" c:type="G_FILE_ATTRIBUTE_UNIX_MODE">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="577">A key in the "unix" namespace for getting the mode of the file
|
|
(e.g. whether the file is a regular file, symlink, etc). See lstat()
|
|
documentation. This attribute is only available for UNIX file systems.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="585"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_NLINK" value="unix::nlink" c:type="G_FILE_ATTRIBUTE_UNIX_NLINK">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="587">A key in the "unix" namespace for getting the number of hard links
|
|
for a file. See lstat() documentation. This attribute is only available
|
|
for UNIX file systems. Corresponding #GFileAttributeType is
|
|
%G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="595"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_RDEV" value="unix::rdev" c:type="G_FILE_ATTRIBUTE_UNIX_RDEV">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="615">A key in the "unix" namespace for getting the device ID for the file
|
|
(if it is a special file). See lstat() documentation. This attribute
|
|
is only available for UNIX file systems. Corresponding #GFileAttributeType
|
|
is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="623"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="FILE_ATTRIBUTE_UNIX_UID" value="unix::uid" c:type="G_FILE_ATTRIBUTE_UNIX_UID">
|
|
<doc xml:space="preserve" filename="gfileinfo.h" line="597">A key in the "unix" namespace for getting the user ID for the file.
|
|
This attribute is only available for UNIX file systems.
|
|
Corresponding #GFileAttributeType is %G_FILE_ATTRIBUTE_TYPE_UINT32.</doc>
|
|
<source-position filename="gfileinfo.h" line="604"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="FILE_DESCRIPTOR_BASED" c:identifier="G_FILE_DESCRIPTOR_BASED" introspectable="0">
|
|
<source-position filename="gfiledescriptorbased.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_DESCRIPTOR_BASED_GET_IFACE" c:identifier="G_FILE_DESCRIPTOR_BASED_GET_IFACE" introspectable="0">
|
|
<source-position filename="gfiledescriptorbased.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_ENUMERATOR" c:identifier="G_FILE_ENUMERATOR" introspectable="0">
|
|
<source-position filename="gfileenumerator.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_ENUMERATOR_CLASS" c:identifier="G_FILE_ENUMERATOR_CLASS" introspectable="0">
|
|
<source-position filename="gfileenumerator.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_ENUMERATOR_GET_CLASS" c:identifier="G_FILE_ENUMERATOR_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfileenumerator.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_GET_IFACE" c:identifier="G_FILE_GET_IFACE" introspectable="0">
|
|
<source-position filename="gfile.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_ICON" c:identifier="G_FILE_ICON" introspectable="0">
|
|
<source-position filename="gfileicon.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_ICON_CLASS" c:identifier="G_FILE_ICON_CLASS" introspectable="0">
|
|
<source-position filename="gfileicon.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_ICON_GET_CLASS" c:identifier="G_FILE_ICON_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfileicon.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_INFO" c:identifier="G_FILE_INFO" introspectable="0">
|
|
<source-position filename="gfileinfo.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_INFO_CLASS" c:identifier="G_FILE_INFO_CLASS" introspectable="0">
|
|
<source-position filename="gfileinfo.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_INFO_GET_CLASS" c:identifier="G_FILE_INFO_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfileinfo.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_INPUT_STREAM" c:identifier="G_FILE_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfileinputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_INPUT_STREAM_CLASS" c:identifier="G_FILE_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfileinputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_INPUT_STREAM_GET_CLASS" c:identifier="G_FILE_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfileinputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_IO_STREAM" c:identifier="G_FILE_IO_STREAM" introspectable="0">
|
|
<source-position filename="gfileiostream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_IO_STREAM_CLASS" c:identifier="G_FILE_IO_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfileiostream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_IO_STREAM_GET_CLASS" c:identifier="G_FILE_IO_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfileiostream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_MONITOR" c:identifier="G_FILE_MONITOR" introspectable="0">
|
|
<source-position filename="gfilemonitor.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_MONITOR_CLASS" c:identifier="G_FILE_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gfilemonitor.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_MONITOR_GET_CLASS" c:identifier="G_FILE_MONITOR_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfilemonitor.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_OUTPUT_STREAM" c:identifier="G_FILE_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfileoutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_OUTPUT_STREAM_CLASS" c:identifier="G_FILE_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfileoutputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILE_OUTPUT_STREAM_GET_CLASS" c:identifier="G_FILE_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfileoutputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILTER_INPUT_STREAM" c:identifier="G_FILTER_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfilterinputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILTER_INPUT_STREAM_CLASS" c:identifier="G_FILTER_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfilterinputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILTER_INPUT_STREAM_GET_CLASS" c:identifier="G_FILTER_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfilterinputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILTER_OUTPUT_STREAM" c:identifier="G_FILTER_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfilteroutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILTER_OUTPUT_STREAM_CLASS" c:identifier="G_FILTER_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfilteroutputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="FILTER_OUTPUT_STREAM_GET_CLASS" c:identifier="G_FILTER_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gfilteroutputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<interface name="File" c:symbol-prefix="file" c:type="GFile" glib:type-name="GFile" glib:get-type="g_file_get_type" glib:type-struct="FileIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6134">#GFile is a high level abstraction for manipulating files on a
|
|
virtual file system. #GFiles are lightweight, immutable objects
|
|
that do no I/O upon creation. It is necessary to understand that
|
|
#GFile objects do not represent files, merely an identifier for a
|
|
file. All file content I/O is implemented as streaming operations
|
|
(see #GInputStream and #GOutputStream).
|
|
|
|
To construct a #GFile, you can use:
|
|
- g_file_new_for_path() if you have a path.
|
|
- g_file_new_for_uri() if you have a URI.
|
|
- g_file_new_for_commandline_arg() for a command line argument.
|
|
- g_file_new_tmp() to create a temporary file from a template.
|
|
- g_file_parse_name() from a UTF-8 string gotten from g_file_get_parse_name().
|
|
- g_file_new_build_filename() to create a file from path elements.
|
|
|
|
One way to think of a #GFile is as an abstraction of a pathname. For
|
|
normal files the system pathname is what is stored internally, but as
|
|
#GFiles are extensible it could also be something else that corresponds
|
|
to a pathname in a userspace implementation of a filesystem.
|
|
|
|
#GFiles make up hierarchies of directories and files that correspond to
|
|
the files on a filesystem. You can move through the file system with
|
|
#GFile using g_file_get_parent() to get an identifier for the parent
|
|
directory, g_file_get_child() to get a child within a directory,
|
|
g_file_resolve_relative_path() to resolve a relative path between two
|
|
#GFiles. There can be multiple hierarchies, so you may not end up at
|
|
the same root if you repeatedly call g_file_get_parent() on two different
|
|
files.
|
|
|
|
All #GFiles have a basename (get with g_file_get_basename()). These names
|
|
are byte strings that are used to identify the file on the filesystem
|
|
(relative to its parent directory) and there is no guarantees that they
|
|
have any particular charset encoding or even make any sense at all. If
|
|
you want to use filenames in a user interface you should use the display
|
|
name that you can get by requesting the
|
|
%G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME attribute with g_file_query_info().
|
|
This is guaranteed to be in UTF-8 and can be used in a user interface.
|
|
But always store the real basename or the #GFile to use to actually
|
|
access the file, because there is no way to go from a display name to
|
|
the actual name.
|
|
|
|
Using #GFile as an identifier has the same weaknesses as using a path
|
|
in that there may be multiple aliases for the same file. For instance,
|
|
hard or soft links may cause two different #GFiles to refer to the same
|
|
file. Other possible causes for aliases are: case insensitive filesystems,
|
|
short and long names on FAT/NTFS, or bind mounts in Linux. If you want to
|
|
check if two #GFiles point to the same file you can query for the
|
|
%G_FILE_ATTRIBUTE_ID_FILE attribute. Note that #GFile does some trivial
|
|
canonicalization of pathnames passed in, so that trivial differences in
|
|
the path string used at creation (duplicated slashes, slash at end of
|
|
path, "." or ".." path segments, etc) does not create different #GFiles.
|
|
|
|
Many #GFile operations have both synchronous and asynchronous versions
|
|
to suit your application. Asynchronous versions of synchronous functions
|
|
simply have _async() appended to their function names. The asynchronous
|
|
I/O functions call a #GAsyncReadyCallback which is then used to finalize
|
|
the operation, producing a GAsyncResult which is then passed to the
|
|
function's matching _finish() operation.
|
|
|
|
It is highly recommended to use asynchronous calls when running within a
|
|
shared main loop, such as in the main thread of an application. This avoids
|
|
I/O operations blocking other sources on the main loop from being dispatched.
|
|
Synchronous I/O operations should be performed from worker threads. See the
|
|
[introduction to asynchronous programming section][async-programming] for
|
|
more.
|
|
|
|
Some #GFile operations almost always take a noticeable amount of time, and
|
|
so do not have synchronous analogs. Notable cases include:
|
|
- g_file_mount_mountable() to mount a mountable file.
|
|
- g_file_unmount_mountable_with_operation() to unmount a mountable file.
|
|
- g_file_eject_mountable_with_operation() to eject a mountable file.
|
|
|
|
## Entity Tags # {#gfile-etag}
|
|
|
|
One notable feature of #GFiles are entity tags, or "etags" for
|
|
short. Entity tags are somewhat like a more abstract version of the
|
|
traditional mtime, and can be used to quickly determine if the file
|
|
has been modified from the version on the file system. See the
|
|
HTTP 1.1
|
|
[specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)
|
|
for HTTP Etag headers, which are a very similar concept.</doc>
|
|
<source-position filename="gfile.h" line="589"/>
|
|
<function name="new_build_filename" c:identifier="g_file_new_build_filename" version="2.56" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23656">Constructs a #GFile from a series of elements using the correct
|
|
separator for filenames.
|
|
|
|
Using this function is equivalent to calling g_build_filename(),
|
|
followed by g_file_new_for_path() on the result.</doc>
|
|
<source-position filename="gfile.h" line="610"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23667">a new #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="first_element" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23658">the first element in the path</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23659">remaining elements in path, terminated by %NULL</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_commandline_arg" c:identifier="g_file_new_for_commandline_arg">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23672">Creates a #GFile with the given argument from the command line.
|
|
The value of @arg can be either a URI, an absolute path or a
|
|
relative path resolved relative to the current working directory.
|
|
This operation never fails, but the returned object might not
|
|
support any I/O operation if @arg points to a malformed path.
|
|
|
|
Note that on Windows, this function expects its argument to be in
|
|
UTF-8 -- not the system code page. This means that you
|
|
should not use this function with string from argv as it is passed
|
|
to main(). g_win32_get_command_line() will return a UTF-8 version of
|
|
the commandline. #GApplication also uses UTF-8 but
|
|
g_application_command_line_create_file_for_arg() may be more useful
|
|
for you there. It is also always possible to use this function with
|
|
#GOptionContext arguments of type %G_OPTION_ARG_FILENAME.</doc>
|
|
<source-position filename="gfile.h" line="599"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23691">a new #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="arg" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23674">a command line string</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_commandline_arg_and_cwd" c:identifier="g_file_new_for_commandline_arg_and_cwd" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23696">Creates a #GFile with the given argument from the command line.
|
|
|
|
This function is similar to g_file_new_for_commandline_arg() except
|
|
that it allows for passing the current working directory as an
|
|
argument instead of using the current working directory of the
|
|
process.
|
|
|
|
This is useful if the commandline argument was given in a context
|
|
other than the invocation of the current process.
|
|
|
|
See also g_application_command_line_create_file_for_arg().</doc>
|
|
<source-position filename="gfile.h" line="601"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23713">a new #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="arg" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23698">a command line string</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cwd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23699">the current working directory of the commandline</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_path" c:identifier="g_file_new_for_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23718">Constructs a #GFile for a given path. This operation never
|
|
fails, but the returned object might not support any I/O
|
|
operation if @path is malformed.</doc>
|
|
<source-position filename="gfile.h" line="595"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23727">a new #GFile for the given @path.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23720">a string containing a relative or absolute path.
|
|
The string must be encoded in the glib filename encoding.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_uri" c:identifier="g_file_new_for_uri">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23732">Constructs a #GFile for a given URI. This operation never
|
|
fails, but the returned object might not support any I/O
|
|
operation if @uri is malformed or if the uri type is
|
|
not supported.</doc>
|
|
<source-position filename="gfile.h" line="597"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23741">a new #GFile for the given @uri.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23734">a UTF-8 string containing a URI</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_tmp" c:identifier="g_file_new_tmp" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23746">Opens a file in the preferred directory for temporary files (as
|
|
returned by g_get_tmp_dir()) and returns a #GFile and
|
|
#GFileIOStream pointing to it.
|
|
|
|
@tmpl should be a string in the GLib file name encoding
|
|
containing a sequence of six 'X' characters, and containing no
|
|
directory components. If it is %NULL, a default template is used.
|
|
|
|
Unlike the other #GFile constructors, this will return %NULL if
|
|
a temporary file could not be created.</doc>
|
|
<source-position filename="gfile.h" line="604"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23764">a new #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="tmpl" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23748">Template for the file
|
|
name, as in g_file_open_tmp(), or %NULL for a default template</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="iostream" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23750">on return, a #GFileIOStream for the created file</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="parse_name" c:identifier="g_file_parse_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23909">Constructs a #GFile with the given @parse_name (i.e. something
|
|
given by g_file_get_parse_name()). This operation never fails,
|
|
but the returned object might not support any I/O operation if
|
|
the @parse_name cannot be parsed.</doc>
|
|
<source-position filename="gfile.h" line="608"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23918">a new #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23911">a file name or path to be parsed</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="append_to" invoker="append_to" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20775">Gets an output stream for appending data to the file.
|
|
If the file doesn't already exist it is created.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level that
|
|
is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
Some file systems don't allow all file names, and may return an
|
|
%G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the
|
|
%G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are
|
|
possible too, and depend on what kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="308"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20801">a #GFileOutputStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20777">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20778">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20779">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="append_to_async" invoker="append_to_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20806">Asynchronously opens @file for appending.
|
|
|
|
For more details, see g_file_append_to() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_append_to_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="312"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20808">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20809">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20810">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20811">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20813">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20815">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="append_to_finish" invoker="append_to_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20828">Finishes an asynchronous file append operation started with
|
|
g_file_append_to_async().</doc>
|
|
<source-position filename="gfile.h" line="318"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20837">a valid #GFileOutputStream
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20830">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20831">#GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="copy" invoker="copy" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21058">Copies the file @source to the location specified by @destination.
|
|
Can not handle recursive copies of directories.
|
|
|
|
If the flag #G_FILE_COPY_OVERWRITE is specified an already
|
|
existing @destination file is overwritten.
|
|
|
|
If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
|
|
will be copied as symlinks, otherwise the target of the
|
|
@source symlink will be copied.
|
|
|
|
If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
|
|
that is possible to copy is copied, not just the default subset (which,
|
|
for instance, does not include the owner, see #GFileInfo).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If @progress_callback is not %NULL, then the operation can be monitored
|
|
by setting this to a #GFileProgressCallback function.
|
|
@progress_callback_data will be passed to this function. It is guaranteed
|
|
that this callback will be called after all data has been transferred with
|
|
the total number of bytes copied during the operation.
|
|
|
|
If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND error
|
|
is returned, independent on the status of the @destination.
|
|
|
|
If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then
|
|
the error %G_IO_ERROR_EXISTS is returned.
|
|
|
|
If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error is returned. If trying to overwrite a directory with a directory the
|
|
%G_IO_ERROR_WOULD_MERGE error is returned.
|
|
|
|
If the source is a directory and the target does not exist, or
|
|
#G_FILE_COPY_OVERWRITE is specified and the target is a file, then the
|
|
%G_IO_ERROR_WOULD_RECURSE error is returned.
|
|
|
|
If you are interested in copying the #GFile object itself (not the on-disk
|
|
file), see g_file_dup().</doc>
|
|
<source-position filename="gfile.h" line="397"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21111">%TRUE on success, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21060">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21061">destination #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21062">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21063">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21065">function to callback with
|
|
progress information, or %NULL if progress information is not needed</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21067">user data to pass to @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="copy_async" invoker="copy_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21115">Copies the file @source to the location specified by @destination
|
|
asynchronously. For details of the behaviour, see g_file_copy().
|
|
|
|
If @progress_callback is not %NULL, then that function that will be called
|
|
just like in g_file_copy(). The callback will run in the default main context
|
|
of the thread calling g_file_copy_async() — the same context as @callback is
|
|
run in.
|
|
|
|
When the operation is finished, @callback will be called. You can then call
|
|
g_file_copy_finish() to get the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="404"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21117">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21118">destination #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21119">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21120">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21121">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21123">function to callback with progress
|
|
information, or %NULL if progress information is not needed</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21125">user data to pass to @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21126">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21127">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="copy_finish" invoker="copy_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21165">Finishes copying the file started with g_file_copy_async().</doc>
|
|
<source-position filename="gfile.h" line="413"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21173">a %TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21167">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21168">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create" invoker="create" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21177">Creates a new file and returns an output stream for writing to it.
|
|
The file must not already exist.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level
|
|
that is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If a file or directory with this name already exists the
|
|
%G_IO_ERROR_EXISTS error will be returned. Some file systems don't
|
|
allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME
|
|
error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will
|
|
be returned. Other errors are possible too, and depend on what kind
|
|
of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="322"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21205">a #GFileOutputStream for the newly created
|
|
file, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21179">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21180">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21181">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_async" invoker="create_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21211">Asynchronously creates a new file and returns an output stream
|
|
for writing to it. The file must not already exist.
|
|
|
|
For more details, see g_file_create() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_create_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="326"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21213">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21214">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21215">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21216">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21218">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21220">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_finish" invoker="create_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21234">Finishes an asynchronous file create operation started with
|
|
g_file_create_async().</doc>
|
|
<source-position filename="gfile.h" line="332"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21243">a #GFileOutputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21236">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21237">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_readwrite" invoker="create_readwrite" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21248">Creates a new file and returns a stream for reading and
|
|
writing to it. The file must not already exist.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level
|
|
that is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If a file or directory with this name already exists, the
|
|
%G_IO_ERROR_EXISTS error will be returned. Some file systems don't
|
|
allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME
|
|
error, and if the name is too long, %G_IO_ERROR_FILENAME_TOO_LONG
|
|
will be returned. Other errors are possible too, and depend on what
|
|
kind of filesystem the file is on.
|
|
|
|
Note that in many non-local file cases read and write streams are
|
|
not supported, so make sure you really need to do read and write
|
|
streaming, rather than just opening for reading or writing.</doc>
|
|
<source-position filename="gfile.h" line="485"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21280">a #GFileIOStream for the newly created
|
|
file, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21250">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21251">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21252">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_readwrite_async" invoker="create_readwrite_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21287">Asynchronously creates a new file and returns a stream
|
|
for reading and writing to it. The file must not already exist.
|
|
|
|
For more details, see g_file_create_readwrite() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_create_readwrite_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="489"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21289">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21290">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21291">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21292">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21294">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21296">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_readwrite_finish" invoker="create_readwrite_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21312">Finishes an asynchronous file create operation started with
|
|
g_file_create_readwrite_async().</doc>
|
|
<source-position filename="gfile.h" line="495"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21321">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21314">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21315">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="delete_file" invoker="delete" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21327">Deletes a file. If the @file is a directory, it will only be
|
|
deleted if it is empty. This has the same semantics as g_unlink().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="354"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21341">%TRUE if the file was deleted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21329">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21330">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="delete_file_async" invoker="delete_async" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21345">Asynchronously delete a file. If the @file is a directory, it will
|
|
only be deleted if it is empty. This has the same semantics as
|
|
g_unlink().</doc>
|
|
<source-position filename="gfile.h" line="357"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21347">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21348">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21349">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21351">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21353">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="delete_file_finish" invoker="delete_finish" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21363">Finishes deleting a file started with g_file_delete_async().</doc>
|
|
<source-position filename="gfile.h" line="362"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21371">%TRUE if the file was deleted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21365">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21366">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="dup" invoker="dup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21387">Duplicates a #GFile handle. This operation does not duplicate
|
|
the actual file or directory represented by the #GFile; see
|
|
g_file_copy() if attempting to copy a file.
|
|
|
|
g_file_dup() is useful when a second handle is needed to the same underlying
|
|
file, for use in a separate thread (#GFile is not thread-safe). For use
|
|
within the same thread, use g_object_ref() to increment the existing object’s
|
|
reference count.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="165"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21402">a new #GFile that is a duplicate
|
|
of the given #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21389">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_mountable" invoker="eject_mountable" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21407">Starts an asynchronous eject on a mountable.
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_eject_mountable_finish().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_eject_mountable_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="446"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21409">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21410">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21411">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21413">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21415">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_mountable_finish" invoker="eject_mountable_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21430">Finishes an asynchronous eject operation started by
|
|
g_file_eject_mountable().</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_eject_mountable_with_operation_finish()
|
|
instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="451"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21439">%TRUE if the @file was ejected successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21432">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21433">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_mountable_with_operation" invoker="eject_mountable_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21446">Starts an asynchronous eject on a mountable.
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_eject_mountable_with_operation_finish().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="548"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21448">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21449">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21450">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21452">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21454">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21456">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_mountable_with_operation_finish" invoker="eject_mountable_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21471">Finishes an asynchronous eject operation started by
|
|
g_file_eject_mountable_with_operation().</doc>
|
|
<source-position filename="gfile.h" line="554"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21480">%TRUE if the @file was ejected successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21473">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21474">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="enumerate_children" invoker="enumerate_children" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21486">Gets the requested information about the files in a directory.
|
|
The result is a #GFileEnumerator object that will give out
|
|
#GFileInfo objects for all the files in the directory.
|
|
|
|
The @attributes value is a string that specifies the file
|
|
attributes that should be gathered. It is not an error if
|
|
it's not possible to read a particular requested attribute
|
|
from a file - it just won't be set. @attributes should
|
|
be a comma-separated list of attributes or attribute wildcards.
|
|
The wildcard "*" means all attributes, and a wildcard like
|
|
"standard::*" means all attributes in the standard namespace.
|
|
An example attribute query be "standard::*,owner::user".
|
|
The standard attributes are available as defines, like
|
|
#G_FILE_ATTRIBUTE_STANDARD_NAME.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will
|
|
be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY
|
|
error will be returned. Other errors are possible too.</doc>
|
|
<source-position filename="gfile.h" line="188"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21519">A #GFileEnumerator if successful,
|
|
%NULL on error. Free the returned object with g_object_unref().</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21488">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21489">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21490">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21491">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="enumerate_children_async" invoker="enumerate_children_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21524">Asynchronously gets the requested information about the files
|
|
in a directory. The result is a #GFileEnumerator object that will
|
|
give out #GFileInfo objects for all the files in the directory.
|
|
|
|
For more details, see g_file_enumerate_children() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can
|
|
then call g_file_enumerate_children_finish() to get the result of
|
|
the operation.</doc>
|
|
<source-position filename="gfile.h" line="193"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21526">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21527">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21528">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21529">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21530">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21532">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21534">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="enumerate_children_finish" invoker="enumerate_children_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21549">Finishes an async enumerate children operation.
|
|
See g_file_enumerate_children_async().</doc>
|
|
<source-position filename="gfile.h" line="200"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21558">a #GFileEnumerator or %NULL
|
|
if an error occurred.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21551">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21552">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="equal" invoker="equal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21803">Checks if the two given #GFiles refer to the same file.
|
|
|
|
Note that two #GFiles that differ can still refer to the same
|
|
file on the filesystem due to various forms of filename
|
|
aliasing.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="167"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21816">%TRUE if @file1 and @file2 are equal.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21805">the first #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="file2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21806">the second #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="find_enclosing_mount" invoker="find_enclosing_mount" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21820">Gets a #GMount for the #GFile.
|
|
|
|
#GMount is returned only for user interesting locations, see
|
|
#GVolumeMonitor. If the #GFileIface for @file does not have a #mount,
|
|
@error will be set to %G_IO_ERROR_NOT_FOUND and %NULL #will be returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="234"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21837">a #GMount where the @file is located
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21822">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21823">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="find_enclosing_mount_async" invoker="find_enclosing_mount_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21843">Asynchronously gets the mount for the file.
|
|
|
|
For more details, see g_file_find_enclosing_mount() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_find_enclosing_mount_finish() to
|
|
get the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="237"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21845">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21846">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21847">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21849">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21851">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="find_enclosing_mount_finish" invoker="find_enclosing_mount_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21864">Finishes an asynchronous find mount request.
|
|
See g_file_find_enclosing_mount_async().</doc>
|
|
<source-position filename="gfile.h" line="242"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21873">#GMount for given @file or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21866">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21867">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_basename">
|
|
<source-position filename="gfile.h" line="173"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_child_for_display_name" invoker="get_child_for_display_name" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21920">Gets the child of @file for a given @display_name (i.e. a UTF-8
|
|
version of the name). If this function fails, it returns %NULL
|
|
and @error will be set. This is very useful when constructing a
|
|
#GFile for a new file and the user entered the filename in the
|
|
user interface, for instance when you select a directory and
|
|
type a filename in the file selector.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="184"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21935">a #GFile to the specified child, or
|
|
%NULL if the display name couldn't be converted.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21922">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21923">string to a possible child</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_parent" invoker="get_parent">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21941">Gets the parent directory for the @file.
|
|
If the @file represents the root directory of the
|
|
file system, then %NULL will be returned.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="177"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21951">a #GFile structure to the
|
|
parent of the given #GFile or %NULL if there is no parent. Free
|
|
the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21943">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_parse_name" invoker="get_parse_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21957">Gets the parse name of the @file.
|
|
A parse name is a UTF-8 string that describes the
|
|
file such that one can get the #GFile back using
|
|
g_file_parse_name().
|
|
|
|
This is generally used to show the #GFile as a nice
|
|
full-pathname kind of string in a user interface,
|
|
like in a location entry.
|
|
|
|
For local files with names that can safely be converted
|
|
to UTF-8 the pathname is used, otherwise the IRI is used
|
|
(a form of URI that allows UTF-8 characters unescaped).
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="176"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21976">a string containing the #GFile's parse name.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21959">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_path">
|
|
<source-position filename="gfile.h" line="174"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_relative_path">
|
|
<source-position filename="gfile.h" line="180"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parent" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="descendant" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_uri" invoker="get_uri">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22013">Gets the URI for the @file.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="175"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22021">a string containing the #GFile's URI.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22015">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_uri_scheme" invoker="get_uri_scheme">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22027">Gets the URI scheme for a #GFile.
|
|
RFC 3986 decodes the scheme as:
|
|
|[
|
|
URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
|
|
]|
|
|
Common schemes include "file", "http", "ftp", etc.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="172"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22040">a string containing the URI scheme for the given
|
|
#GFile. The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22029">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="has_uri_scheme" invoker="has_uri_scheme">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22088">Checks to see if a #GFile has a given URI scheme.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22097">%TRUE if #GFile's backend supports the
|
|
given URI scheme, %FALSE if URI scheme is %NULL,
|
|
not supported, or #GFile is invalid.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22090">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22091">a string containing a URI scheme</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="hash" invoker="hash">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22103">Creates a hash value for a #GFile.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22111">0 if @file is not a valid #GFile, otherwise an
|
|
integer that can be used as hash value for the #GFile.
|
|
This function is intended for easily hashing a #GFile to
|
|
add to a #GHashTable or similar data structure.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22105">#gconstpointer to a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_native" invoker="is_native">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23007">Checks to see if a file is native to the platform.
|
|
|
|
A native file is one expressed in the platform-native filename format,
|
|
e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local,
|
|
as it might be on a locally mounted remote filesystem.
|
|
|
|
On some systems non-native files may be available using the native
|
|
filesystem via a userspace filesystem (FUSE), in these cases this call
|
|
will return %FALSE, but g_file_get_path() will still return a native path.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="169"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23023">%TRUE if @file is native</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23009">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="make_directory" invoker="make_directory" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23215">Creates a directory. Note that this will only create a child directory
|
|
of the immediate parent directory of the path or URI given by the #GFile.
|
|
To recursively create directories, see g_file_make_directory_with_parents().
|
|
This function will fail if the parent directory does not exist, setting
|
|
@error to %G_IO_ERROR_NOT_FOUND. If the file system doesn't support
|
|
creating directories, this function will fail, setting @error to
|
|
%G_IO_ERROR_NOT_SUPPORTED.
|
|
|
|
For a local #GFile the newly created directory will have the default
|
|
(current) ownership and permissions of the current process.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="378"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23237">%TRUE on successful creation, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23217">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23218">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="make_directory_async" invoker="make_directory_async" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23241">Asynchronously creates a directory.</doc>
|
|
<source-position filename="gfile.h" line="381"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23243">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23244">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23245">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23247">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23249">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="make_directory_finish" invoker="make_directory_finish" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23257">Finishes an asynchronous directory creation, started with
|
|
g_file_make_directory_async().</doc>
|
|
<source-position filename="gfile.h" line="386"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23266">%TRUE on successful directory creation, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23259">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23260">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="make_symbolic_link" invoker="make_symbolic_link" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23298">Creates a symbolic link named @file which contains the string
|
|
@symlink_value.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="390"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23314">%TRUE on the creation of a new symlink, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23300">a #GFile with the name of the symlink to create</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="symlink_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23301">a string with the path for the target
|
|
of the new symlink</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23303">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="measure_disk_usage" invoker="measure_disk_usage" version="2.38" introspectable="0" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23318">Recursively measures the disk usage of @file.
|
|
|
|
This is essentially an analog of the 'du' command, but it also
|
|
reports the number of directories and non-directory files encountered
|
|
(including things like symbolic links).
|
|
|
|
By default, errors are only reported against the toplevel file
|
|
itself. Errors found while recursing are silently ignored, unless
|
|
%G_FILE_MEASURE_REPORT_ANY_ERROR is given in @flags.
|
|
|
|
The returned size, @disk_usage, is in bytes and should be formatted
|
|
with g_format_size() in order to get something reasonable for showing
|
|
in a user interface.
|
|
|
|
@progress_callback and @progress_data can be given to request
|
|
periodic progress updates while scanning. See the documentation for
|
|
#GFileMeasureProgressCallback for information about when and how the
|
|
callback will be invoked.</doc>
|
|
<source-position filename="gfile.h" line="566"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23349">%TRUE if successful, with the out parameters set.
|
|
%FALSE otherwise, with @error set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23320">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23321">#GFileMeasureFlags</doc>
|
|
<type name="FileMeasureFlags" c:type="GFileMeasureFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23322">optional #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23323">a #GFileMeasureProgressCallback</doc>
|
|
<type name="FileMeasureProgressCallback" c:type="GFileMeasureProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23324">user_data for @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="disk_usage" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23325">the number of bytes of disk space used</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_dirs" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23326">the number of directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_files" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23327">the number of non-directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="measure_disk_usage_async" invoker="measure_disk_usage_async" version="2.38" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23355">Recursively measures the disk usage of @file.
|
|
|
|
This is the asynchronous version of g_file_measure_disk_usage(). See
|
|
there for more information.</doc>
|
|
<source-position filename="gfile.h" line="575"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23357">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23358">#GFileMeasureFlags</doc>
|
|
<type name="FileMeasureFlags" c:type="GFileMeasureFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23359">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23360">optional #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23361">a #GFileMeasureProgressCallback</doc>
|
|
<type name="FileMeasureProgressCallback" c:type="GFileMeasureProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23362">user_data for @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23363">a #GAsyncReadyCallback to call when complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23364">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="measure_disk_usage_finish" invoker="measure_disk_usage_finish" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23375">Collects the results from an earlier call to
|
|
g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for
|
|
more information.</doc>
|
|
<source-position filename="gfile.h" line="583"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23388">%TRUE if successful, with the out parameters set.
|
|
%FALSE otherwise, with @error set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23377">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23378">the #GAsyncResult passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="disk_usage" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23379">the number of bytes of disk space used</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_dirs" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23380">the number of directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_files" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23381">the number of non-directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="monitor_dir" invoker="monitor_directory" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23426">Obtains a directory monitor for the given file.
|
|
This may fail if directory monitoring is not supported.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
It does not make sense for @flags to contain
|
|
%G_FILE_MONITOR_WATCH_HARD_LINKS, since hard links can not be made to
|
|
directories. It is not possible to monitor all the files in a
|
|
directory for changes made via hard links; if you want to do this then
|
|
you must register individual watches with g_file_monitor().</doc>
|
|
<source-position filename="gfile.h" line="465"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23447">a #GFileMonitor for the given @file,
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23428">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23429">a set of #GFileMonitorFlags</doc>
|
|
<type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23430">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="monitor_file" invoker="monitor_file" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23470">Obtains a file monitor for the given file. If no file notification
|
|
mechanism exists, then regular polling of the file is used.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If @flags contains %G_FILE_MONITOR_WATCH_HARD_LINKS then the monitor
|
|
will also attempt to report changes made to the file via another
|
|
filename (ie, a hard link). Without this flag, you can only rely on
|
|
changes made through the filename contained in @file to be
|
|
reported. Using this flag may result in an increase in resource
|
|
usage, and may not have any effect depending on the #GFileMonitor
|
|
backend and/or filesystem type.</doc>
|
|
<source-position filename="gfile.h" line="469"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23493">a #GFileMonitor for the given @file,
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23472">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23473">a set of #GFileMonitorFlags</doc>
|
|
<type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23474">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_enclosing_volume" invoker="mount_enclosing_volume">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23520">Starts a @mount_operation, mounting the volume that contains
|
|
the file @location.
|
|
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_mount_enclosing_volume_finish().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="455"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="location" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23522">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23523">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23524">a #GMountOperation
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23526">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23528">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23530">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_enclosing_volume_finish" invoker="mount_enclosing_volume_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23545">Finishes a mount operation started by g_file_mount_enclosing_volume().</doc>
|
|
<source-position filename="gfile.h" line="461"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23553">%TRUE if successful. If an error has occurred,
|
|
this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="location" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23547">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23548">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_mountable" invoker="mount_mountable">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23559">Mounts a file of type G_FILE_TYPE_MOUNTABLE.
|
|
Using @mount_operation, you can request callbacks when, for instance,
|
|
passwords are needed during authentication.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_mount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="427"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23561">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23562">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23563">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23565">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23567">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23569">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_mountable_finish" invoker="mount_mountable_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23585">Finishes a mount operation. See g_file_mount_mountable() for details.
|
|
|
|
Finish an asynchronous mount operation that was started
|
|
with g_file_mount_mountable().</doc>
|
|
<source-position filename="gfile.h" line="433"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23596">a #GFile or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23587">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23588">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="move" invoker="move" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23601">Tries to move the file or directory @source to the location specified
|
|
by @destination. If native move operations are supported then this is
|
|
used, otherwise a copy + delete fallback is used. The native
|
|
implementation may support moving directories (for instance on moves
|
|
inside the same filesystem), but the fallback code does not.
|
|
|
|
If the flag #G_FILE_COPY_OVERWRITE is specified an already
|
|
existing @destination file is overwritten.
|
|
|
|
If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
|
|
will be copied as symlinks, otherwise the target of the
|
|
@source symlink will be copied.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If @progress_callback is not %NULL, then the operation can be monitored
|
|
by setting this to a #GFileProgressCallback function.
|
|
@progress_callback_data will be passed to this function. It is
|
|
guaranteed that this callback will be called after all data has been
|
|
transferred with the total number of bytes copied during the operation.
|
|
|
|
If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND
|
|
error is returned, independent on the status of the @destination.
|
|
|
|
If #G_FILE_COPY_OVERWRITE is not specified and the target exists,
|
|
then the error %G_IO_ERROR_EXISTS is returned.
|
|
|
|
If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error is returned. If trying to overwrite a directory with a directory the
|
|
%G_IO_ERROR_WOULD_MERGE error is returned.
|
|
|
|
If the source is a directory and the target does not exist, or
|
|
#G_FILE_COPY_OVERWRITE is specified and the target is a file, then
|
|
the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native
|
|
move operation isn't available).</doc>
|
|
<source-position filename="gfile.h" line="417"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23652">%TRUE on successful move, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23603">#GFile pointing to the source location</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23604">#GFile pointing to the destination location</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23605">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23606">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23608">#GFileProgressCallback
|
|
function for updates</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23610">gpointer to user data for
|
|
the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="open_readwrite" invoker="open_readwrite" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23770">Opens an existing file for reading and writing. The result is
|
|
a #GFileIOStream that can be used to read and write the contents
|
|
of the file.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will
|
|
be returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error will be returned. Other errors are possible too, and depend on
|
|
what kind of filesystem the file is on. Note that in many non-local
|
|
file cases read and write streams are not supported, so make sure you
|
|
really need to do read and write streaming, rather than just opening
|
|
for reading or writing.</doc>
|
|
<source-position filename="gfile.h" line="474"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23793">#GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23772">#GFile to open</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23773">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="open_readwrite_async" invoker="open_readwrite_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23799">Asynchronously opens @file for reading and writing.
|
|
|
|
For more details, see g_file_open_readwrite() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_open_readwrite_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="477"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23801">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23802">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23803">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23805">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23807">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="open_readwrite_finish" invoker="open_readwrite_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23822">Finishes an asynchronous file read operation started with
|
|
g_file_open_readwrite_async().</doc>
|
|
<source-position filename="gfile.h" line="482"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23831">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23824">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23825">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="poll_mountable" invoker="poll_mountable" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23940">Polls a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_mount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="558"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23942">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23943">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23944">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23946">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="poll_mountable_finish" invoker="poll_mountable_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23962">Finishes a poll operation. See g_file_poll_mountable() for details.
|
|
|
|
Finish an asynchronous poll operation that was polled
|
|
with g_file_poll_mountable().</doc>
|
|
<source-position filename="gfile.h" line="562"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23973">%TRUE if the operation finished successfully. %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23964">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23965">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="prefix_matches" invoker="has_prefix">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22063">Checks whether @file has the prefix specified by @prefix.
|
|
|
|
In other words, if the names of initial elements of @file's
|
|
pathname match @prefix. Only full pathname elements are matched,
|
|
so a path like /foo is not considered a prefix of /foobar, only
|
|
of /foo/bar.
|
|
|
|
A #GFile is not a prefix of itself. If you want to check for
|
|
equality, use g_file_equal().
|
|
|
|
This call does no I/O, as it works purely on names. As such it can
|
|
sometimes return %FALSE even if @file is inside a @prefix (from a
|
|
filesystem point of view), because the prefix of @file is an alias
|
|
of @prefix.</doc>
|
|
<source-position filename="gfile.h" line="178"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22083">%TRUE if the @files's parent, grandparent, etc is @prefix,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="prefix" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22066">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22065">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_filesystem_info" invoker="query_filesystem_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24080">Similar to g_file_query_info(), but obtains information
|
|
about the filesystem the @file is on, rather than the file itself.
|
|
For instance the amount of space available and the type of
|
|
the filesystem.
|
|
|
|
The @attributes value is a string that specifies the attributes
|
|
that should be gathered. It is not an error if it's not possible
|
|
to read a particular requested attribute from a file - it just
|
|
won't be set. @attributes should be a comma-separated list of
|
|
attributes or attribute wildcards. The wildcard "*" means all
|
|
attributes, and a wildcard like "filesystem::*" means all attributes
|
|
in the filesystem namespace. The standard namespace for filesystem
|
|
attributes is "filesystem". Common attributes of interest are
|
|
#G_FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem
|
|
in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes available),
|
|
and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will
|
|
be returned. Other errors are possible too, and depend on what
|
|
kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="220"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24114">a #GFileInfo or %NULL if there was an error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24082">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24083">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24084">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_filesystem_info_async" invoker="query_filesystem_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24119">Asynchronously gets the requested information about the filesystem
|
|
that the specified @file is on. The result is a #GFileInfo object
|
|
that contains key-value attributes (such as type or size for the
|
|
file).
|
|
|
|
For more details, see g_file_query_filesystem_info() which is the
|
|
synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can
|
|
then call g_file_query_info_finish() to get the result of the
|
|
operation.</doc>
|
|
<source-position filename="gfile.h" line="224"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24121">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24122">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24123">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24124">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24126">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24128">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_filesystem_info_finish" invoker="query_filesystem_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24144">Finishes an asynchronous filesystem info query.
|
|
See g_file_query_filesystem_info_async().</doc>
|
|
<source-position filename="gfile.h" line="230"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24153">#GFileInfo for given @file
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24146">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24147">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info" invoker="query_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24159">Gets the requested information about specified @file.
|
|
The result is a #GFileInfo object that contains key-value
|
|
attributes (such as the type or size of the file).
|
|
|
|
The @attributes value is a string that specifies the file
|
|
attributes that should be gathered. It is not an error if
|
|
it's not possible to read a particular requested attribute
|
|
from a file - it just won't be set. @attributes should be a
|
|
comma-separated list of attributes or attribute wildcards.
|
|
The wildcard "*" means all attributes, and a wildcard like
|
|
"standard::*" means all attributes in the standard namespace.
|
|
An example attribute query be "standard::*,owner::user".
|
|
The standard attributes are available as defines, like
|
|
#G_FILE_ATTRIBUTE_STANDARD_NAME.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
For symlinks, normally the information about the target of the
|
|
symlink is returned, rather than information about the symlink
|
|
itself. However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS
|
|
in @flags the information about the symlink itself will be returned.
|
|
Also, for symlinks that point to non-existing files the information
|
|
about the symlink itself will be returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be
|
|
returned. Other errors are possible too, and depend on what kind of
|
|
filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="204"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24199">a #GFileInfo for the given @file, or %NULL
|
|
on error. Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24161">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24162">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24163">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24164">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_async" invoker="query_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24204">Asynchronously gets the requested information about specified @file.
|
|
The result is a #GFileInfo object that contains key-value attributes
|
|
(such as type or size for the file).
|
|
|
|
For more details, see g_file_query_info() which is the synchronous
|
|
version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can
|
|
then call g_file_query_info_finish() to get the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="209"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24206">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24207">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24208">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24209">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24210">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24212">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24214">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_finish" invoker="query_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24228">Finishes an asynchronous file info query.
|
|
See g_file_query_info_async().</doc>
|
|
<source-position filename="gfile.h" line="216"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24237">#GFileInfo for given @file
|
|
or %NULL on error. Free the returned object with
|
|
g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24230">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24231">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_settable_attributes" invoker="query_settable_attributes" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24243">Obtain the list of settable attributes for the file.
|
|
|
|
Returns the type and full attribute name of all the attributes
|
|
that can be set on this file. This doesn't mean setting it will
|
|
always succeed though, you might get an access failure, or some
|
|
specific file may not support a specific attribute.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="260"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24261">a #GFileAttributeInfoList describing the settable attributes.
|
|
When you are done with it, release it with
|
|
g_file_attribute_info_list_unref()</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24245">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24246">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_writable_namespaces" invoker="query_writable_namespaces" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24267">Obtain the list of attribute namespaces where new attributes
|
|
can be created by a user. An example of this is extended
|
|
attributes (in the "xattr" namespace).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="266"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24282">a #GFileAttributeInfoList describing the writable namespaces.
|
|
When you are done with it, release it with
|
|
g_file_attribute_info_list_unref()</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24269">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24270">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_async" invoker="read_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24311">Asynchronously opens @file for reading.
|
|
|
|
For more details, see g_file_read() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_read_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="299"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24313">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24314">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24315">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24317">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24319">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_finish" invoker="read_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24332">Finishes an asynchronous file read operation started with
|
|
g_file_read_async().</doc>
|
|
<source-position filename="gfile.h" line="304"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24341">a #GFileInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24334">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24335">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_fn" invoker="read" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24288">Opens a file for reading. The result is a #GFileInputStream that
|
|
can be used to read the contents of the file.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be
|
|
returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error will be returned. Other errors are possible too, and depend
|
|
on what kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="296"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24306">#GFileInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24290">#GFile to read</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24291">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="replace" invoker="replace" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24346">Returns an output stream for overwriting the file, possibly
|
|
creating a backup copy of the file first. If the file doesn't exist,
|
|
it will be created.
|
|
|
|
This will try to replace the file in the safest way possible so
|
|
that any errors during the writing will not affect an already
|
|
existing copy of the file. For instance, for local files it
|
|
may write to a temporary file and then atomically rename over
|
|
the destination when the stream is closed.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level that
|
|
is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If you pass in a non-%NULL @etag value and @file already exists, then
|
|
this value is compared to the current entity tag of the file, and if
|
|
they differ an %G_IO_ERROR_WRONG_ETAG error is returned. This
|
|
generally means that the file has been changed since you last read
|
|
it. You can get the new etag from g_file_output_stream_get_etag()
|
|
after you've finished writing and closed the #GFileOutputStream. When
|
|
you load a new file you can use g_file_input_stream_query_info() to
|
|
get the etag of the file.
|
|
|
|
If @make_backup is %TRUE, this function will attempt to make a
|
|
backup of the current file before overwriting it. If this fails
|
|
a %G_IO_ERROR_CANT_CREATE_BACKUP error will be returned. If you
|
|
want to replace anyway, try again with @make_backup set to %FALSE.
|
|
|
|
If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will
|
|
be returned, and if the file is some other form of non-regular file
|
|
then a %G_IO_ERROR_NOT_REGULAR_FILE error will be returned. Some
|
|
file systems don't allow all file names, and may return an
|
|
%G_IO_ERROR_INVALID_FILENAME error, and if the name is to long
|
|
%G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are
|
|
possible too, and depend on what kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="336"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24399">a #GFileOutputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24348">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24349">an optional [entity tag][gfile-etag]
|
|
for the current #GFile, or #NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24351">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24352">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24353">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="replace_async" invoker="replace_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24404">Asynchronously overwrites the file, replacing the contents,
|
|
possibly creating a backup copy of the file first.
|
|
|
|
For more details, see g_file_replace() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_replace_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="342"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24406">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24407">an [entity tag][gfile-etag] for the current #GFile,
|
|
or %NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24409">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24410">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24411">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24412">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24414">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24416">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="replace_finish" invoker="replace_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24542">Finishes an asynchronous file replace operation started with
|
|
g_file_replace_async().</doc>
|
|
<source-position filename="gfile.h" line="350"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24551">a #GFileOutputStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24544">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24545">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="replace_readwrite" invoker="replace_readwrite" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24556">Returns an output stream for overwriting the file in readwrite mode,
|
|
possibly creating a backup copy of the file first. If the file doesn't
|
|
exist, it will be created.
|
|
|
|
For details about the behaviour, see g_file_replace() which does the
|
|
same thing but returns an output stream only.
|
|
|
|
Note that in many non-local file cases read and write streams are not
|
|
supported, so make sure you really need to do read and write streaming,
|
|
rather than just opening for reading or writing.</doc>
|
|
<source-position filename="gfile.h" line="498"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24578">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24558">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24559">an optional [entity tag][gfile-etag]
|
|
for the current #GFile, or #NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24561">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24562">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24563">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="replace_readwrite_async" invoker="replace_readwrite_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24584">Asynchronously overwrites the file in read-write mode,
|
|
replacing the contents, possibly creating a backup copy
|
|
of the file first.
|
|
|
|
For more details, see g_file_replace_readwrite() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_replace_readwrite_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="504"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24586">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24587">an [entity tag][gfile-etag] for the current #GFile,
|
|
or %NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24589">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24590">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24591">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24592">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24594">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24596">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="replace_readwrite_finish" invoker="replace_readwrite_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24613">Finishes an asynchronous file replace operation started with
|
|
g_file_replace_readwrite_async().</doc>
|
|
<source-position filename="gfile.h" line="512"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24622">a #GFileIOStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24615">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24616">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="resolve_relative_path" invoker="resolve_relative_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24628">Resolves a relative path for @file to an absolute path.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="182"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24637">#GFile to the resolved path.
|
|
%NULL if @relative_path is %NULL or if @file is invalid.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24630">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="relative_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24631">a given relative path string</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_attribute" invoker="set_attribute" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24643">Sets an attribute in the file with attribute name @attribute to @value.
|
|
|
|
Some attributes can be unset by setting @type to
|
|
%G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="272"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24664">%TRUE if the attribute was set, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24645">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24646">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24647">The type of the attribute</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType"/>
|
|
</parameter>
|
|
<parameter name="value_p" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24648">a pointer to the value (or the pointer
|
|
itself if the type is a pointer type)</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24650">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24651">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_attributes_async" invoker="set_attributes_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24799">Asynchronously sets the attributes of @file with @info.
|
|
|
|
For more details, see g_file_set_attributes_from_info(),
|
|
which is the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_set_attributes_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="284"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24801">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24802">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24803">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24804">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24805">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24807">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24808">a #gpointer</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_attributes_finish" invoker="set_attributes_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24821">Finishes setting an attribute started in g_file_set_attributes_async().</doc>
|
|
<source-position filename="gfile.h" line="291"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24830">%TRUE if the attributes were set correctly, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24823">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24824">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="info" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24825">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_attributes_from_info" invoker="set_attributes_from_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24834">Tries to set all attributes in the #GFileInfo on the target
|
|
values, not stopping on the first error.
|
|
|
|
If there is any error during this operation then @error will
|
|
be set to the first error. Error on particular fields are flagged
|
|
by setting the "status" field in the attribute value to
|
|
%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can
|
|
also detect further errors.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="279"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24856">%FALSE if there was any error, %TRUE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24836">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24837">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24838">#GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24839">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_display_name" invoker="set_display_name" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24860">Renames @file to the specified display name.
|
|
|
|
The display name is converted from UTF-8 to the correct encoding
|
|
for the target filesystem if possible and the @file is renamed to this.
|
|
|
|
If you want to implement a rename operation in the user interface the
|
|
edit name (#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the
|
|
initial value in the rename widget, and then the result after editing
|
|
should be passed to g_file_set_display_name().
|
|
|
|
On success the resulting converted filename is returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="246"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24884">a #GFile specifying what @file was renamed to,
|
|
or %NULL if there was an error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24862">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24863">a string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24864">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_display_name_async" invoker="set_display_name_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24890">Asynchronously sets the display name for a given #GFile.
|
|
|
|
For more details, see g_file_set_display_name() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_set_display_name_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="250"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24892">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24893">a string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24894">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24895">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24897">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24899">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_display_name_finish" invoker="set_display_name_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24912">Finishes setting a display name started with
|
|
g_file_set_display_name_async().</doc>
|
|
<source-position filename="gfile.h" line="256"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24921">a #GFile or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24914">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24915">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start_mountable" invoker="start_mountable" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24926">Starts a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
Using @start_operation, you can request callbacks when, for instance,
|
|
passwords are needed during authentication.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_mount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="516"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24928">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24929">flags affecting the operation</doc>
|
|
<type name="DriveStartFlags" c:type="GDriveStartFlags"/>
|
|
</parameter>
|
|
<parameter name="start_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24930">a #GMountOperation, or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24931">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24932">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24933">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="start_mountable_finish" invoker="start_mountable_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24951">Finishes a start operation. See g_file_start_mountable() for details.
|
|
|
|
Finish an asynchronous start operation that was started
|
|
with g_file_start_mountable().</doc>
|
|
<source-position filename="gfile.h" line="522"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24962">%TRUE if the operation finished successfully. %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24953">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24954">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop_mountable" invoker="stop_mountable" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24968">Stops a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_stop_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="526"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24970">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24971">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24972">a #GMountOperation,
|
|
or %NULL to avoid user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24974">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24976">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24978">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="stop_mountable_finish" invoker="stop_mountable_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24994">Finishes an stop operation, see g_file_stop_mountable() for details.
|
|
|
|
Finish an asynchronous stop operation that was started
|
|
with g_file_stop_mountable().</doc>
|
|
<source-position filename="gfile.h" line="532"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25005">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24996">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24997">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="trash" invoker="trash" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25025">Sends @file to the "Trashcan", if possible. This is similar to
|
|
deleting it, but the user can recover it before emptying the trashcan.
|
|
Not all file systems support trashing, so this call can return the
|
|
%G_IO_ERROR_NOT_SUPPORTED error.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="366"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25041">%TRUE on successful trash, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25027">#GFile to send to trash</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25028">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="trash_async" invoker="trash_async" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25045">Asynchronously sends @file to the Trash location, if possible.</doc>
|
|
<source-position filename="gfile.h" line="369"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25047">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25048">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25049">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25051">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25053">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="trash_finish" invoker="trash_finish" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25061">Finishes an asynchronous file trashing operation, started with
|
|
g_file_trash_async().</doc>
|
|
<source-position filename="gfile.h" line="374"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25070">%TRUE on successful trash, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25063">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25064">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount_mountable" invoker="unmount_mountable" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25075">Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_unmount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_unmount_mountable_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="437"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25077">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25078">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25079">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25081">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25083">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount_mountable_finish" invoker="unmount_mountable_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25099">Finishes an unmount operation, see g_file_unmount_mountable() for details.
|
|
|
|
Finish an asynchronous unmount operation that was started
|
|
with g_file_unmount_mountable().</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_unmount_mountable_with_operation_finish()
|
|
instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="442"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25110">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25101">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25102">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount_mountable_with_operation" invoker="unmount_mountable_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25117">Unmounts a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_unmount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="538"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25119">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25120">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25121">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25123">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25125">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25127">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount_mountable_with_operation_finish" invoker="unmount_mountable_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25143">Finishes an unmount operation,
|
|
see g_file_unmount_mountable_with_operation() for details.
|
|
|
|
Finish an asynchronous unmount operation that was started
|
|
with g_file_unmount_mountable_with_operation().</doc>
|
|
<source-position filename="gfile.h" line="544"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25155">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25145">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25146">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="append_to" c:identifier="g_file_append_to" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20775">Gets an output stream for appending data to the file.
|
|
If the file doesn't already exist it is created.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level that
|
|
is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
Some file systems don't allow all file names, and may return an
|
|
%G_IO_ERROR_INVALID_FILENAME error. If the file is a directory the
|
|
%G_IO_ERROR_IS_DIRECTORY error will be returned. Other errors are
|
|
possible too, and depend on what kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="672"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20801">a #GFileOutputStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20777">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20778">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20779">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="append_to_async" c:identifier="g_file_append_to_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20806">Asynchronously opens @file for appending.
|
|
|
|
For more details, see g_file_append_to() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_append_to_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="689"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20808">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20809">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20810">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20811">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20813">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20815">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="append_to_finish" c:identifier="g_file_append_to_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20828">Finishes an asynchronous file append operation started with
|
|
g_file_append_to_async().</doc>
|
|
<source-position filename="gfile.h" line="696"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20837">a valid #GFileOutputStream
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20830">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20831">#GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy" c:identifier="g_file_copy" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21058">Copies the file @source to the location specified by @destination.
|
|
Can not handle recursive copies of directories.
|
|
|
|
If the flag #G_FILE_COPY_OVERWRITE is specified an already
|
|
existing @destination file is overwritten.
|
|
|
|
If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
|
|
will be copied as symlinks, otherwise the target of the
|
|
@source symlink will be copied.
|
|
|
|
If the flag #G_FILE_COPY_ALL_METADATA is specified then all the metadata
|
|
that is possible to copy is copied, not just the default subset (which,
|
|
for instance, does not include the owner, see #GFileInfo).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If @progress_callback is not %NULL, then the operation can be monitored
|
|
by setting this to a #GFileProgressCallback function.
|
|
@progress_callback_data will be passed to this function. It is guaranteed
|
|
that this callback will be called after all data has been transferred with
|
|
the total number of bytes copied during the operation.
|
|
|
|
If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND error
|
|
is returned, independent on the status of the @destination.
|
|
|
|
If #G_FILE_COPY_OVERWRITE is not specified and the target exists, then
|
|
the error %G_IO_ERROR_EXISTS is returned.
|
|
|
|
If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error is returned. If trying to overwrite a directory with a directory the
|
|
%G_IO_ERROR_WOULD_MERGE error is returned.
|
|
|
|
If the source is a directory and the target does not exist, or
|
|
#G_FILE_COPY_OVERWRITE is specified and the target is a file, then the
|
|
%G_IO_ERROR_WOULD_RECURSE error is returned.
|
|
|
|
If you are interested in copying the #GFile object itself (not the on-disk
|
|
file), see g_file_dup().</doc>
|
|
<source-position filename="gfile.h" line="897"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21111">%TRUE on success, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21060">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21061">destination #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21062">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21063">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21065">function to callback with
|
|
progress information, or %NULL if progress information is not needed</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21067">user data to pass to @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy_async" c:identifier="g_file_copy_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21115">Copies the file @source to the location specified by @destination
|
|
asynchronously. For details of the behaviour, see g_file_copy().
|
|
|
|
If @progress_callback is not %NULL, then that function that will be called
|
|
just like in g_file_copy(). The callback will run in the default main context
|
|
of the thread calling g_file_copy_async() — the same context as @callback is
|
|
run in.
|
|
|
|
When the operation is finished, @callback will be called. You can then call
|
|
g_file_copy_finish() to get the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="905"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21117">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21118">destination #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21119">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21120">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21121">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21123">function to callback with progress
|
|
information, or %NULL if progress information is not needed</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21125">user data to pass to @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21126">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21127">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy_attributes" c:identifier="g_file_copy_attributes" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21142">Copies the file attributes from @source to @destination.
|
|
|
|
Normally only a subset of the file attributes are copied,
|
|
those that are copies in a normal file copy operation
|
|
(which for instance does not include e.g. owner). However
|
|
if #G_FILE_COPY_ALL_METADATA is specified in @flags, then
|
|
all the metadata that is possible to copy is copied. This
|
|
is useful when implementing move by copy + delete source.</doc>
|
|
<source-position filename="gfile.h" line="1095"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21160">%TRUE if the attributes were copied successfully,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21144">a #GFile with attributes</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21145">a #GFile to copy attributes to</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21146">a set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21147">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy_finish" c:identifier="g_file_copy_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21165">Finishes copying the file started with g_file_copy_async().</doc>
|
|
<source-position filename="gfile.h" line="915"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21173">a %TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21167">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21168">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create" c:identifier="g_file_create" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21177">Creates a new file and returns an output stream for writing to it.
|
|
The file must not already exist.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level
|
|
that is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If a file or directory with this name already exists the
|
|
%G_IO_ERROR_EXISTS error will be returned. Some file systems don't
|
|
allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME
|
|
error, and if the name is to long %G_IO_ERROR_FILENAME_TOO_LONG will
|
|
be returned. Other errors are possible too, and depend on what kind
|
|
of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="677"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21205">a #GFileOutputStream for the newly created
|
|
file, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21179">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21180">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21181">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_async" c:identifier="g_file_create_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21211">Asynchronously creates a new file and returns an output stream
|
|
for writing to it. The file must not already exist.
|
|
|
|
For more details, see g_file_create() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_create_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="700"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21213">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21214">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21215">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21216">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21218">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21220">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_finish" c:identifier="g_file_create_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21234">Finishes an asynchronous file create operation started with
|
|
g_file_create_async().</doc>
|
|
<source-position filename="gfile.h" line="707"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21243">a #GFileOutputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21236">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21237">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_readwrite" c:identifier="g_file_create_readwrite" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21248">Creates a new file and returns a stream for reading and
|
|
writing to it. The file must not already exist.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level
|
|
that is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If a file or directory with this name already exists, the
|
|
%G_IO_ERROR_EXISTS error will be returned. Some file systems don't
|
|
allow all file names, and may return an %G_IO_ERROR_INVALID_FILENAME
|
|
error, and if the name is too long, %G_IO_ERROR_FILENAME_TOO_LONG
|
|
will be returned. Other errors are possible too, and depend on what
|
|
kind of filesystem the file is on.
|
|
|
|
Note that in many non-local file cases read and write streams are
|
|
not supported, so make sure you really need to do read and write
|
|
streaming, rather than just opening for reading or writing.</doc>
|
|
<source-position filename="gfile.h" line="738"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21280">a #GFileIOStream for the newly created
|
|
file, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21250">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21251">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21252">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_readwrite_async" c:identifier="g_file_create_readwrite_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21287">Asynchronously creates a new file and returns a stream
|
|
for reading and writing to it. The file must not already exist.
|
|
|
|
For more details, see g_file_create_readwrite() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_create_readwrite_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="743"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21289">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21290">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21291">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21292">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21294">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21296">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_readwrite_finish" c:identifier="g_file_create_readwrite_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21312">Finishes an asynchronous file create operation started with
|
|
g_file_create_readwrite_async().</doc>
|
|
<source-position filename="gfile.h" line="750"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21321">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21314">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21315">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="delete" c:identifier="g_file_delete" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21327">Deletes a file. If the @file is a directory, it will only be
|
|
deleted if it is empty. This has the same semantics as g_unlink().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="863"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21341">%TRUE if the file was deleted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21329">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21330">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="delete_async" c:identifier="g_file_delete_async" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21345">Asynchronously delete a file. If the @file is a directory, it will
|
|
only be deleted if it is empty. This has the same semantics as
|
|
g_unlink().</doc>
|
|
<source-position filename="gfile.h" line="868"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21347">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21348">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21349">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21351">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21353">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="delete_finish" c:identifier="g_file_delete_finish" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21363">Finishes deleting a file started with g_file_delete_async().</doc>
|
|
<source-position filename="gfile.h" line="875"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21371">%TRUE if the file was deleted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21365">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21366">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dup" c:identifier="g_file_dup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21387">Duplicates a #GFile handle. This operation does not duplicate
|
|
the actual file or directory represented by the #GFile; see
|
|
g_file_copy() if attempting to copy a file.
|
|
|
|
g_file_dup() is useful when a second handle is needed to the same underlying
|
|
file, for use in a separate thread (#GFile is not thread-safe). For use
|
|
within the same thread, use g_object_ref() to increment the existing object’s
|
|
reference count.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="613"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21402">a new #GFile that is a duplicate
|
|
of the given #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21389">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_mountable" c:identifier="g_file_eject_mountable" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21407">Starts an asynchronous eject on a mountable.
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_eject_mountable_finish().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_eject_mountable_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="1072"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21409">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21410">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21411">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21413">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21415">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_mountable_finish" c:identifier="g_file_eject_mountable_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21430">Finishes an asynchronous eject operation started by
|
|
g_file_eject_mountable().</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_eject_mountable_with_operation_finish()
|
|
instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="1079"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21439">%TRUE if the @file was ejected successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21432">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21433">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_mountable_with_operation" c:identifier="g_file_eject_mountable_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21446">Starts an asynchronous eject on a mountable.
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_eject_mountable_with_operation_finish().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1083"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21448">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21449">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21450">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21452">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21454">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21456">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_mountable_with_operation_finish" c:identifier="g_file_eject_mountable_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21471">Finishes an asynchronous eject operation started by
|
|
g_file_eject_mountable_with_operation().</doc>
|
|
<source-position filename="gfile.h" line="1090"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21480">%TRUE if the @file was ejected successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21473">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21474">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="enumerate_children" c:identifier="g_file_enumerate_children" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21486">Gets the requested information about the files in a directory.
|
|
The result is a #GFileEnumerator object that will give out
|
|
#GFileInfo objects for all the files in the directory.
|
|
|
|
The @attributes value is a string that specifies the file
|
|
attributes that should be gathered. It is not an error if
|
|
it's not possible to read a particular requested attribute
|
|
from a file - it just won't be set. @attributes should
|
|
be a comma-separated list of attributes or attribute wildcards.
|
|
The wildcard "*" means all attributes, and a wildcard like
|
|
"standard::*" means all attributes in the standard namespace.
|
|
An example attribute query be "standard::*,owner::user".
|
|
The standard attributes are available as defines, like
|
|
#G_FILE_ATTRIBUTE_STANDARD_NAME.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will
|
|
be returned. If the file is not a directory, the %G_IO_ERROR_NOT_DIRECTORY
|
|
error will be returned. Other errors are possible too.</doc>
|
|
<source-position filename="gfile.h" line="829"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21519">A #GFileEnumerator if successful,
|
|
%NULL on error. Free the returned object with g_object_unref().</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21488">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21489">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21490">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21491">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="enumerate_children_async" c:identifier="g_file_enumerate_children_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21524">Asynchronously gets the requested information about the files
|
|
in a directory. The result is a #GFileEnumerator object that will
|
|
give out #GFileInfo objects for all the files in the directory.
|
|
|
|
For more details, see g_file_enumerate_children() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can
|
|
then call g_file_enumerate_children_finish() to get the result of
|
|
the operation.</doc>
|
|
<source-position filename="gfile.h" line="835"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21526">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21527">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21528">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21529">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21530">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21532">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21534">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="enumerate_children_finish" c:identifier="g_file_enumerate_children_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21549">Finishes an async enumerate children operation.
|
|
See g_file_enumerate_children_async().</doc>
|
|
<source-position filename="gfile.h" line="843"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21558">a #GFileEnumerator or %NULL
|
|
if an error occurred.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21551">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21552">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="equal" c:identifier="g_file_equal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21803">Checks if the two given #GFiles refer to the same file.
|
|
|
|
Note that two #GFiles that differ can still refer to the same
|
|
file on the filesystem due to various forms of filename
|
|
aliasing.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="617"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21816">%TRUE if @file1 and @file2 are equal.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21805">the first #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="file2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21806">the second #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="find_enclosing_mount" c:identifier="g_file_find_enclosing_mount" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21820">Gets a #GMount for the #GFile.
|
|
|
|
#GMount is returned only for user interesting locations, see
|
|
#GVolumeMonitor. If the #GFileIface for @file does not have a #mount,
|
|
@error will be set to %G_IO_ERROR_NOT_FOUND and %NULL #will be returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="815"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21837">a #GMount where the @file is located
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21822">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21823">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="find_enclosing_mount_async" c:identifier="g_file_find_enclosing_mount_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21843">Asynchronously gets the mount for the file.
|
|
|
|
For more details, see g_file_find_enclosing_mount() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_find_enclosing_mount_finish() to
|
|
get the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="819"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21845">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21846">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21847">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21849">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21851">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="find_enclosing_mount_finish" c:identifier="g_file_find_enclosing_mount_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21864">Finishes an asynchronous find mount request.
|
|
See g_file_find_enclosing_mount_async().</doc>
|
|
<source-position filename="gfile.h" line="825"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21873">#GMount for given @file or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21866">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21867">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_basename" c:identifier="g_file_get_basename">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21878">Gets the base name (the last component of the path) for a given #GFile.
|
|
|
|
If called for the top level of a system (such as the filesystem root
|
|
or a uri like sftp://host/) it will return a single directory separator
|
|
(and on Windows, possibly a drive letter).
|
|
|
|
The base name is a byte string (not UTF-8). It has no defined encoding
|
|
or rules other than it may not contain zero bytes. If you want to use
|
|
filenames in a user interface you should use the display name that you
|
|
can get by requesting the %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME
|
|
attribute with g_file_query_info().
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="620"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21896">string containing the #GFile's
|
|
base name, or %NULL if given #GFile is invalid. The returned string
|
|
should be freed with g_free() when no longer needed.</doc>
|
|
<type name="filename" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21880">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_child" c:identifier="g_file_get_child">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21902">Gets a child of @file with basename equal to @name.
|
|
|
|
Note that the file with that specific name might not exist, but
|
|
you can still have a #GFile that points to it. You can use this
|
|
for instance to create that file.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="635"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21915">a #GFile to a child specified by @name.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21904">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21905">string containing the child's basename</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_child_for_display_name" c:identifier="g_file_get_child_for_display_name" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21920">Gets the child of @file for a given @display_name (i.e. a UTF-8
|
|
version of the name). If this function fails, it returns %NULL
|
|
and @error will be set. This is very useful when constructing a
|
|
#GFile for a new file and the user entered the filename in the
|
|
user interface, for instance when you select a directory and
|
|
type a filename in the file selector.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="638"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21935">a #GFile to the specified child, or
|
|
%NULL if the display name couldn't be converted.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21922">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21923">string to a possible child</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_parent" c:identifier="g_file_get_parent">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21941">Gets the parent directory for the @file.
|
|
If the @file represents the root directory of the
|
|
file system, then %NULL will be returned.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="630"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21951">a #GFile structure to the
|
|
parent of the given #GFile or %NULL if there is no parent. Free
|
|
the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21943">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_parse_name" c:identifier="g_file_get_parse_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21957">Gets the parse name of the @file.
|
|
A parse name is a UTF-8 string that describes the
|
|
file such that one can get the #GFile back using
|
|
g_file_parse_name().
|
|
|
|
This is generally used to show the #GFile as a nice
|
|
full-pathname kind of string in a user interface,
|
|
like in a location entry.
|
|
|
|
For local files with names that can safely be converted
|
|
to UTF-8 the pathname is used, otherwise the IRI is used
|
|
(a form of URI that allows UTF-8 characters unescaped).
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="628"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21976">a string containing the #GFile's parse name.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21959">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_path" c:identifier="g_file_get_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21982">Gets the local pathname for #GFile, if one exists. If non-%NULL, this is
|
|
guaranteed to be an absolute, canonical path. It might contain symlinks.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="622"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21991">string containing the #GFile's path,
|
|
or %NULL if no such path exists. The returned string should be freed
|
|
with g_free() when no longer needed.</doc>
|
|
<type name="filename" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21984">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_relative_path" c:identifier="g_file_get_relative_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21997">Gets the path for @descendant relative to @parent.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="645"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22006">string with the relative path from
|
|
@descendant to @parent, or %NULL if @descendant doesn't have @parent as
|
|
prefix. The returned string should be freed with g_free() when
|
|
no longer needed.</doc>
|
|
<type name="filename" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="parent" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21999">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="descendant" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22000">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uri" c:identifier="g_file_get_uri">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22013">Gets the URI for the @file.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="626"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22021">a string containing the #GFile's URI.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22015">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uri_scheme" c:identifier="g_file_get_uri_scheme">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22027">Gets the URI scheme for a #GFile.
|
|
RFC 3986 decodes the scheme as:
|
|
|[
|
|
URI = scheme ":" hier-part [ "?" query ] [ "#" fragment ]
|
|
]|
|
|
Common schemes include "file", "http", "ftp", etc.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="656"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22040">a string containing the URI scheme for the given
|
|
#GFile. The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22029">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_parent" c:identifier="g_file_has_parent" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22046">Checks if @file has a parent, and optionally, if it is @parent.
|
|
|
|
If @parent is %NULL then this function returns %TRUE if @file has any
|
|
parent at all. If @parent is non-%NULL then %TRUE is only returned
|
|
if @file is an immediate child of @parent.</doc>
|
|
<source-position filename="gfile.h" line="632"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22057">%TRUE if @file is an immediate child of @parent (or any parent in
|
|
the case that @parent is %NULL).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22048">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22049">the parent to check for, or %NULL</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_prefix" c:identifier="g_file_has_prefix">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22063">Checks whether @file has the prefix specified by @prefix.
|
|
|
|
In other words, if the names of initial elements of @file's
|
|
pathname match @prefix. Only full pathname elements are matched,
|
|
so a path like /foo is not considered a prefix of /foobar, only
|
|
of /foo/bar.
|
|
|
|
A #GFile is not a prefix of itself. If you want to check for
|
|
equality, use g_file_equal().
|
|
|
|
This call does no I/O, as it works purely on names. As such it can
|
|
sometimes return %FALSE even if @file is inside a @prefix (from a
|
|
filesystem point of view), because the prefix of @file is an alias
|
|
of @prefix.</doc>
|
|
<source-position filename="gfile.h" line="642"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22083">%TRUE if the @files's parent, grandparent, etc is @prefix,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22065">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="prefix" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22066">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_uri_scheme" c:identifier="g_file_has_uri_scheme">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22088">Checks to see if a #GFile has a given URI scheme.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="653"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22097">%TRUE if #GFile's backend supports the
|
|
given URI scheme, %FALSE if URI scheme is %NULL,
|
|
not supported, or #GFile is invalid.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22090">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22091">a string containing a URI scheme</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="hash" c:identifier="g_file_hash">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22103">Creates a hash value for a #GFile.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="615"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22111">0 if @file is not a valid #GFile, otherwise an
|
|
integer that can be used as hash value for the #GFile.
|
|
This function is intended for easily hashing a #GFile to
|
|
add to a #GHashTable or similar data structure.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22105">#gconstpointer to a #GFile</doc>
|
|
<type name="File" c:type="gconstpointer"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_native" c:identifier="g_file_is_native">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23007">Checks to see if a file is native to the platform.
|
|
|
|
A native file is one expressed in the platform-native filename format,
|
|
e.g. "C:\Windows" or "/usr/bin/". This does not mean the file is local,
|
|
as it might be on a locally mounted remote filesystem.
|
|
|
|
On some systems non-native files may be available using the native
|
|
filesystem via a userspace filesystem (FUSE), in these cases this call
|
|
will return %FALSE, but g_file_get_path() will still return a native path.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="651"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23023">%TRUE if @file is native</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23009">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_bytes" c:identifier="g_file_load_bytes" version="2.56" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23027">Loads the contents of @file and returns it as #GBytes.
|
|
|
|
If @file is a resource:// based URI, the resulting bytes will reference the
|
|
embedded resource instead of a copy. Otherwise, this is equivalent to calling
|
|
g_file_load_contents() and g_bytes_new_take().
|
|
|
|
For resources, @etag_out will be set to %NULL.
|
|
|
|
The data contained in the resulting #GBytes is always zero-terminated, but
|
|
this is not included in the #GBytes length. The resulting #GBytes should be
|
|
freed with g_bytes_unref() when no longer in use.</doc>
|
|
<source-position filename="gfile.h" line="1268"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23047">a #GBytes or %NULL and @error is set</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23029">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23030">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="etag_out" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23031">a location to place the current
|
|
entity tag for the file, or %NULL if the entity tag is not needed</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_bytes_async" c:identifier="g_file_load_bytes_async" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23052">Asynchronously loads the contents of @file as #GBytes.
|
|
|
|
If @file is a resource:// based URI, the resulting bytes will reference the
|
|
embedded resource instead of a copy. Otherwise, this is equivalent to calling
|
|
g_file_load_contents_async() and g_bytes_new_take().
|
|
|
|
@callback should call g_file_load_bytes_finish() to get the result of this
|
|
asynchronous operation.
|
|
|
|
See g_file_load_bytes() for more information.</doc>
|
|
<source-position filename="gfile.h" line="1273"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23054">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23055">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23056">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23058">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_bytes_finish" c:identifier="g_file_load_bytes_finish" version="2.56" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23075">Completes an asynchronous request to g_file_load_bytes_async().
|
|
|
|
For resources, @etag_out will be set to %NULL.
|
|
|
|
The data contained in the resulting #GBytes is always zero-terminated, but
|
|
this is not included in the #GBytes length. The resulting #GBytes should be
|
|
freed with g_bytes_unref() when no longer in use.
|
|
|
|
See g_file_load_bytes() for more information.</doc>
|
|
<source-position filename="gfile.h" line="1278"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23093">a #GBytes or %NULL and @error is set</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23077">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23078">a #GAsyncResult provided to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="etag_out" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23079">a location to place the current
|
|
entity tag for the file, or %NULL if the entity tag is not needed</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_contents" c:identifier="g_file_load_contents" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23098">Loads the content of the file into memory. The data is always
|
|
zero-terminated, but this is not included in the resultant @length.
|
|
The returned @content should be freed with g_free() when no longer
|
|
needed.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1198"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23118">%TRUE if the @file's contents were successfully loaded.
|
|
%FALSE if there were errors.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23100">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23101">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="contents" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23102">a location to place the contents of the file</doc>
|
|
<array length="2" zero-terminated="0" c:type="char**">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23103">a location to place the length of the contents of the file,
|
|
or %NULL if the length is not needed</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="etag_out" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23105">a location to place the current entity tag for the file,
|
|
or %NULL if the entity tag is not needed</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_contents_async" c:identifier="g_file_load_contents_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23123">Starts an asynchronous load of the @file's contents.
|
|
|
|
For more details, see g_file_load_contents() which is
|
|
the synchronous version of this call.
|
|
|
|
When the load operation has completed, @callback will be called
|
|
with @user data. To finish the operation, call
|
|
g_file_load_contents_finish() with the #GAsyncResult returned by
|
|
the @callback.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1205"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23125">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23126">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23127">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23128">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_contents_finish" c:identifier="g_file_load_contents_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23146">Finishes an asynchronous load of the @file's contents.
|
|
The contents are placed in @contents, and @length is set to the
|
|
size of the @contents string. The @content should be freed with
|
|
g_free() when no longer needed. If @etag_out is present, it will be
|
|
set to the new entity tag for the @file.</doc>
|
|
<source-position filename="gfile.h" line="1210"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23163">%TRUE if the load was successful. If %FALSE and @error is
|
|
present, it will be set appropriately.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23148">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23149">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="contents" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23150">a location to place the contents of the file</doc>
|
|
<array length="2" zero-terminated="0" c:type="char**">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23151">a location to place the length of the contents of the file,
|
|
or %NULL if the length is not needed</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="etag_out" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23153">a location to place the current entity tag for the file,
|
|
or %NULL if the entity tag is not needed</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_partial_contents_async" c:identifier="g_file_load_partial_contents_async" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23168">Reads the partial contents of a file. A #GFileReadMoreCallback should
|
|
be used to stop reading from the file when appropriate, else this
|
|
function will behave exactly as g_file_load_contents_async(). This
|
|
operation can be finished by g_file_load_partial_contents_finish().
|
|
|
|
Users of this function should be aware that @user_data is passed to
|
|
both the @read_more_callback and the @callback.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1217"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23170">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23171">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="read_more_callback" transfer-ownership="none" scope="call" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23172">a
|
|
#GFileReadMoreCallback to receive partial data
|
|
and to specify whether further data should be read</doc>
|
|
<type name="FileReadMoreCallback" c:type="GFileReadMoreCallback"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23175">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23177">the data to pass to the callback functions</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_partial_contents_finish" c:identifier="g_file_load_partial_contents_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23193">Finishes an asynchronous partial load operation that was started
|
|
with g_file_load_partial_contents_async(). The data is always
|
|
zero-terminated, but this is not included in the resultant @length.
|
|
The returned @content should be freed with g_free() when no longer
|
|
needed.</doc>
|
|
<source-position filename="gfile.h" line="1223"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23210">%TRUE if the load was successful. If %FALSE and @error is
|
|
present, it will be set appropriately.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23195">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23196">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="contents" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23197">a location to place the contents of the file</doc>
|
|
<array length="2" zero-terminated="0" c:type="char**">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23198">a location to place the length of the contents of the file,
|
|
or %NULL if the length is not needed</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="etag_out" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23200">a location to place the current entity tag for the file,
|
|
or %NULL if the entity tag is not needed</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="make_directory" c:identifier="g_file_make_directory" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23215">Creates a directory. Note that this will only create a child directory
|
|
of the immediate parent directory of the path or URI given by the #GFile.
|
|
To recursively create directories, see g_file_make_directory_with_parents().
|
|
This function will fail if the parent directory does not exist, setting
|
|
@error to %G_IO_ERROR_NOT_FOUND. If the file system doesn't support
|
|
creating directories, this function will fail, setting @error to
|
|
%G_IO_ERROR_NOT_SUPPORTED.
|
|
|
|
For a local #GFile the newly created directory will have the default
|
|
(current) ownership and permissions of the current process.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="927"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23237">%TRUE on successful creation, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23217">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23218">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="make_directory_async" c:identifier="g_file_make_directory_async" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23241">Asynchronously creates a directory.</doc>
|
|
<source-position filename="gfile.h" line="931"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23243">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23244">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23245">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23247">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23249">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="make_directory_finish" c:identifier="g_file_make_directory_finish" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23257">Finishes an asynchronous directory creation, started with
|
|
g_file_make_directory_async().</doc>
|
|
<source-position filename="gfile.h" line="937"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23266">%TRUE on successful directory creation, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23259">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23260">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="make_directory_with_parents" c:identifier="g_file_make_directory_with_parents" version="2.18" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23271">Creates a directory and any parent directories that may not
|
|
exist similar to 'mkdir -p'. If the file system does not support
|
|
creating directories, this function will fail, setting @error to
|
|
%G_IO_ERROR_NOT_SUPPORTED. If the directory itself already exists,
|
|
this function will fail setting @error to %G_IO_ERROR_EXISTS, unlike
|
|
the similar g_mkdir_with_parents().
|
|
|
|
For a local #GFile the newly created directories will have the default
|
|
(current) ownership and permissions of the current process.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="942"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23292">%TRUE if all directories have been successfully created, %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23273">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23274">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="make_symbolic_link" c:identifier="g_file_make_symbolic_link" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23298">Creates a symbolic link named @file which contains the string
|
|
@symlink_value.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="946"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23314">%TRUE on the creation of a new symlink, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23300">a #GFile with the name of the symlink to create</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="symlink_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23301">a string with the path for the target
|
|
of the new symlink</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23303">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="measure_disk_usage" c:identifier="g_file_measure_disk_usage" version="2.38" introspectable="0" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23318">Recursively measures the disk usage of @file.
|
|
|
|
This is essentially an analog of the 'du' command, but it also
|
|
reports the number of directories and non-directory files encountered
|
|
(including things like symbolic links).
|
|
|
|
By default, errors are only reported against the toplevel file
|
|
itself. Errors found while recursing are silently ignored, unless
|
|
%G_FILE_MEASURE_REPORT_ANY_ERROR is given in @flags.
|
|
|
|
The returned size, @disk_usage, is in bytes and should be formatted
|
|
with g_format_size() in order to get something reasonable for showing
|
|
in a user interface.
|
|
|
|
@progress_callback and @progress_data can be given to request
|
|
periodic progress updates while scanning. See the documentation for
|
|
#GFileMeasureProgressCallback for information about when and how the
|
|
callback will be invoked.</doc>
|
|
<source-position filename="gfile.h" line="1119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23349">%TRUE if successful, with the out parameters set.
|
|
%FALSE otherwise, with @error set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23320">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23321">#GFileMeasureFlags</doc>
|
|
<type name="FileMeasureFlags" c:type="GFileMeasureFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23322">optional #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23323">a #GFileMeasureProgressCallback</doc>
|
|
<type name="FileMeasureProgressCallback" c:type="GFileMeasureProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23324">user_data for @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="disk_usage" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23325">the number of bytes of disk space used</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_dirs" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23326">the number of directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_files" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23327">the number of non-directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="measure_disk_usage_async" c:identifier="g_file_measure_disk_usage_async" version="2.38" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23355">Recursively measures the disk usage of @file.
|
|
|
|
This is the asynchronous version of g_file_measure_disk_usage(). See
|
|
there for more information.</doc>
|
|
<source-position filename="gfile.h" line="1130"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23357">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23358">#GFileMeasureFlags</doc>
|
|
<type name="FileMeasureFlags" c:type="GFileMeasureFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23359">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23360">optional #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23361">a #GFileMeasureProgressCallback</doc>
|
|
<type name="FileMeasureProgressCallback" c:type="GFileMeasureProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23362">user_data for @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23363">a #GAsyncReadyCallback to call when complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23364">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="measure_disk_usage_finish" c:identifier="g_file_measure_disk_usage_finish" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23375">Collects the results from an earlier call to
|
|
g_file_measure_disk_usage_async(). See g_file_measure_disk_usage() for
|
|
more information.</doc>
|
|
<source-position filename="gfile.h" line="1140"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23388">%TRUE if successful, with the out parameters set.
|
|
%FALSE otherwise, with @error set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23377">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23378">the #GAsyncResult passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="disk_usage" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23379">the number of bytes of disk space used</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_dirs" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23380">the number of directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_files" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23381">the number of non-directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="monitor" c:identifier="g_file_monitor" version="2.18" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23394">Obtains a file or directory monitor for the given file,
|
|
depending on the type of the file.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1113"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23409">a #GFileMonitor for the given @file,
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23396">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23397">a set of #GFileMonitorFlags</doc>
|
|
<type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23398">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="monitor_directory" c:identifier="g_file_monitor_directory" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23426">Obtains a directory monitor for the given file.
|
|
This may fail if directory monitoring is not supported.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
It does not make sense for @flags to contain
|
|
%G_FILE_MONITOR_WATCH_HARD_LINKS, since hard links can not be made to
|
|
directories. It is not possible to monitor all the files in a
|
|
directory for changes made via hard links; if you want to do this then
|
|
you must register individual watches with g_file_monitor().</doc>
|
|
<source-position filename="gfile.h" line="1103"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23447">a #GFileMonitor for the given @file,
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23428">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23429">a set of #GFileMonitorFlags</doc>
|
|
<type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23430">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="monitor_file" c:identifier="g_file_monitor_file" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23470">Obtains a file monitor for the given file. If no file notification
|
|
mechanism exists, then regular polling of the file is used.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If @flags contains %G_FILE_MONITOR_WATCH_HARD_LINKS then the monitor
|
|
will also attempt to report changes made to the file via another
|
|
filename (ie, a hard link). Without this flag, you can only rely on
|
|
changes made through the filename contained in @file to be
|
|
reported. Using this flag may result in an increase in resource
|
|
usage, and may not have any effect depending on the #GFileMonitor
|
|
backend and/or filesystem type.</doc>
|
|
<source-position filename="gfile.h" line="1108"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23493">a #GFileMonitor for the given @file,
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23472">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23473">a set of #GFileMonitorFlags</doc>
|
|
<type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23474">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="mount_enclosing_volume" c:identifier="g_file_mount_enclosing_volume">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23520">Starts a @mount_operation, mounting the volume that contains
|
|
the file @location.
|
|
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_mount_enclosing_volume_finish().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1028"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="location" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23522">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23523">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23524">a #GMountOperation
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23526">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23528">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23530">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="mount_enclosing_volume_finish" c:identifier="g_file_mount_enclosing_volume_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23545">Finishes a mount operation started by g_file_mount_enclosing_volume().</doc>
|
|
<source-position filename="gfile.h" line="1035"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23553">%TRUE if successful. If an error has occurred,
|
|
this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="location" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23547">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23548">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="mount_mountable" c:identifier="g_file_mount_mountable">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23559">Mounts a file of type G_FILE_TYPE_MOUNTABLE.
|
|
Using @mount_operation, you can request callbacks when, for instance,
|
|
passwords are needed during authentication.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_mount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="1039"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23561">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23562">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23563">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23565">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23567">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23569">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="mount_mountable_finish" c:identifier="g_file_mount_mountable_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23585">Finishes a mount operation. See g_file_mount_mountable() for details.
|
|
|
|
Finish an asynchronous mount operation that was started
|
|
with g_file_mount_mountable().</doc>
|
|
<source-position filename="gfile.h" line="1046"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23596">a #GFile or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23587">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23588">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="move" c:identifier="g_file_move" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23601">Tries to move the file or directory @source to the location specified
|
|
by @destination. If native move operations are supported then this is
|
|
used, otherwise a copy + delete fallback is used. The native
|
|
implementation may support moving directories (for instance on moves
|
|
inside the same filesystem), but the fallback code does not.
|
|
|
|
If the flag #G_FILE_COPY_OVERWRITE is specified an already
|
|
existing @destination file is overwritten.
|
|
|
|
If the flag #G_FILE_COPY_NOFOLLOW_SYMLINKS is specified then symlinks
|
|
will be copied as symlinks, otherwise the target of the
|
|
@source symlink will be copied.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If @progress_callback is not %NULL, then the operation can be monitored
|
|
by setting this to a #GFileProgressCallback function.
|
|
@progress_callback_data will be passed to this function. It is
|
|
guaranteed that this callback will be called after all data has been
|
|
transferred with the total number of bytes copied during the operation.
|
|
|
|
If the @source file does not exist, then the %G_IO_ERROR_NOT_FOUND
|
|
error is returned, independent on the status of the @destination.
|
|
|
|
If #G_FILE_COPY_OVERWRITE is not specified and the target exists,
|
|
then the error %G_IO_ERROR_EXISTS is returned.
|
|
|
|
If trying to overwrite a file over a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error is returned. If trying to overwrite a directory with a directory the
|
|
%G_IO_ERROR_WOULD_MERGE error is returned.
|
|
|
|
If the source is a directory and the target does not exist, or
|
|
#G_FILE_COPY_OVERWRITE is specified and the target is a file, then
|
|
the %G_IO_ERROR_WOULD_RECURSE error may be returned (if the native
|
|
move operation isn't available).</doc>
|
|
<source-position filename="gfile.h" line="919"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23652">%TRUE on successful move, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23603">#GFile pointing to the source location</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23604">#GFile pointing to the destination location</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23605">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23606">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23608">#GFileProgressCallback
|
|
function for updates</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23610">gpointer to user data for
|
|
the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="open_readwrite" c:identifier="g_file_open_readwrite" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23770">Opens an existing file for reading and writing. The result is
|
|
a #GFileIOStream that can be used to read and write the contents
|
|
of the file.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will
|
|
be returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error will be returned. Other errors are possible too, and depend on
|
|
what kind of filesystem the file is on. Note that in many non-local
|
|
file cases read and write streams are not supported, so make sure you
|
|
really need to do read and write streaming, rather than just opening
|
|
for reading or writing.</doc>
|
|
<source-position filename="gfile.h" line="724"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23793">#GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23772">#GFile to open</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23773">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="open_readwrite_async" c:identifier="g_file_open_readwrite_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23799">Asynchronously opens @file for reading and writing.
|
|
|
|
For more details, see g_file_open_readwrite() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_open_readwrite_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="728"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23801">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23802">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23803">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23805">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23807">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="open_readwrite_finish" c:identifier="g_file_open_readwrite_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23822">Finishes an asynchronous file read operation started with
|
|
g_file_open_readwrite_async().</doc>
|
|
<source-position filename="gfile.h" line="734"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23831">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23824">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23825">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_path" c:identifier="g_file_peek_path" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23922">Exactly like g_file_get_path(), but caches the result via
|
|
g_object_set_qdata_full(). This is useful for example in C
|
|
applications which mix `g_file_*` APIs with native ones. It
|
|
also avoids an extra duplicated string when possible, so will be
|
|
generally more efficient.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="624"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23934">string containing the #GFile's path,
|
|
or %NULL if no such path exists. The returned string is owned by @file.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23924">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="poll_mountable" c:identifier="g_file_poll_mountable" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23940">Polls a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_mount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="1171"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23942">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23943">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23944">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23946">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="poll_mountable_finish" c:identifier="g_file_poll_mountable_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23962">Finishes a poll operation. See g_file_poll_mountable() for details.
|
|
|
|
Finish an asynchronous poll operation that was polled
|
|
with g_file_poll_mountable().</doc>
|
|
<source-position filename="gfile.h" line="1176"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23973">%TRUE if the operation finished successfully. %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23964">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23965">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_default_handler" c:identifier="g_file_query_default_handler" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23979">Returns the #GAppInfo that is registered as the default
|
|
application to handle the file specified by @file.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1183"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23992">a #GAppInfo if the handle was found,
|
|
%NULL if there were errors.
|
|
When you are done with it, release it with g_object_unref()</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23981">a #GFile to open</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23982">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_default_handler_async" c:identifier="g_file_query_default_handler_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23998">Async version of g_file_query_default_handler().</doc>
|
|
<source-position filename="gfile.h" line="1187"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24000">a #GFile to open</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24001">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24002">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24003">a #GAsyncReadyCallback to call when the request is done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24004">data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_default_handler_finish" c:identifier="g_file_query_default_handler_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24012">Finishes a g_file_query_default_handler_async() operation.</doc>
|
|
<source-position filename="gfile.h" line="1193"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24020">a #GAppInfo if the handle was found,
|
|
%NULL if there were errors.
|
|
When you are done with it, release it with g_object_unref()</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24014">a #GFile to open</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24015">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_exists" c:identifier="g_file_query_exists">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24027">Utility function to check if a particular file exists. This is
|
|
implemented using g_file_query_info() and as such does blocking I/O.
|
|
|
|
Note that in many cases it is [racy to first check for file existence](https://en.wikipedia.org/wiki/Time_of_check_to_time_of_use)
|
|
and then execute something based on the outcome of that, because the
|
|
file might have been created or removed in between the operations. The
|
|
general approach to handling that is to not check, but just do the
|
|
operation and handle the errors as they come.
|
|
|
|
As an example of race-free checking, take the case of reading a file,
|
|
and if it doesn't exist, creating it. There are two racy versions: read
|
|
it, and on error create it; and: check if it exists, if not create it.
|
|
These can both result in two processes creating the file (with perhaps
|
|
a partially written file as the result). The correct approach is to
|
|
always try to create the file with g_file_create() which will either
|
|
atomically create the file or fail with a %G_IO_ERROR_EXISTS error.
|
|
|
|
However, in many cases an existence check is useful in a user interface,
|
|
for instance to make a menu item sensitive/insensitive, so that you don't
|
|
have to fool users that something is possible and then just show an error
|
|
dialog. If you do this, you should make sure to also handle the errors
|
|
that can happen due to races when you execute the operation.</doc>
|
|
<source-position filename="gfile.h" line="774"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24056">%TRUE if the file exists (and can be detected without error),
|
|
%FALSE otherwise (or if cancelled).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24029">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24030">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_file_type" c:identifier="g_file_query_file_type" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24061">Utility function to inspect the #GFileType of a file. This is
|
|
implemented using g_file_query_info() and as such does blocking I/O.
|
|
|
|
The primary use case of this method is to check if a file is
|
|
a regular file, directory, or symlink.</doc>
|
|
<source-position filename="gfile.h" line="777"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24074">The #GFileType of the file and #G_FILE_TYPE_UNKNOWN
|
|
if the file does not exist</doc>
|
|
<type name="FileType" c:type="GFileType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24063">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24064">a set of #GFileQueryInfoFlags passed to g_file_query_info()</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24065">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_filesystem_info" c:identifier="g_file_query_filesystem_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24080">Similar to g_file_query_info(), but obtains information
|
|
about the filesystem the @file is on, rather than the file itself.
|
|
For instance the amount of space available and the type of
|
|
the filesystem.
|
|
|
|
The @attributes value is a string that specifies the attributes
|
|
that should be gathered. It is not an error if it's not possible
|
|
to read a particular requested attribute from a file - it just
|
|
won't be set. @attributes should be a comma-separated list of
|
|
attributes or attribute wildcards. The wildcard "*" means all
|
|
attributes, and a wildcard like "filesystem::*" means all attributes
|
|
in the filesystem namespace. The standard namespace for filesystem
|
|
attributes is "filesystem". Common attributes of interest are
|
|
#G_FILE_ATTRIBUTE_FILESYSTEM_SIZE (the total size of the filesystem
|
|
in bytes), #G_FILE_ATTRIBUTE_FILESYSTEM_FREE (number of bytes available),
|
|
and #G_FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will
|
|
be returned. Other errors are possible too, and depend on what
|
|
kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="799"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24114">a #GFileInfo or %NULL if there was an error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24082">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24083">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24084">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_filesystem_info_async" c:identifier="g_file_query_filesystem_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24119">Asynchronously gets the requested information about the filesystem
|
|
that the specified @file is on. The result is a #GFileInfo object
|
|
that contains key-value attributes (such as type or size for the
|
|
file).
|
|
|
|
For more details, see g_file_query_filesystem_info() which is the
|
|
synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can
|
|
then call g_file_query_info_finish() to get the result of the
|
|
operation.</doc>
|
|
<source-position filename="gfile.h" line="804"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24121">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24122">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24123">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24124">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24126">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24128">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_filesystem_info_finish" c:identifier="g_file_query_filesystem_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24144">Finishes an asynchronous filesystem info query.
|
|
See g_file_query_filesystem_info_async().</doc>
|
|
<source-position filename="gfile.h" line="811"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24153">#GFileInfo for given @file
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24146">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24147">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info" c:identifier="g_file_query_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24159">Gets the requested information about specified @file.
|
|
The result is a #GFileInfo object that contains key-value
|
|
attributes (such as the type or size of the file).
|
|
|
|
The @attributes value is a string that specifies the file
|
|
attributes that should be gathered. It is not an error if
|
|
it's not possible to read a particular requested attribute
|
|
from a file - it just won't be set. @attributes should be a
|
|
comma-separated list of attributes or attribute wildcards.
|
|
The wildcard "*" means all attributes, and a wildcard like
|
|
"standard::*" means all attributes in the standard namespace.
|
|
An example attribute query be "standard::*,owner::user".
|
|
The standard attributes are available as defines, like
|
|
#G_FILE_ATTRIBUTE_STANDARD_NAME.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
For symlinks, normally the information about the target of the
|
|
symlink is returned, rather than information about the symlink
|
|
itself. However if you pass #G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS
|
|
in @flags the information about the symlink itself will be returned.
|
|
Also, for symlinks that point to non-existing files the information
|
|
about the symlink itself will be returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be
|
|
returned. Other errors are possible too, and depend on what kind of
|
|
filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="781"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24199">a #GFileInfo for the given @file, or %NULL
|
|
on error. Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24161">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24162">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24163">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24164">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_async" c:identifier="g_file_query_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24204">Asynchronously gets the requested information about specified @file.
|
|
The result is a #GFileInfo object that contains key-value attributes
|
|
(such as type or size for the file).
|
|
|
|
For more details, see g_file_query_info() which is the synchronous
|
|
version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can
|
|
then call g_file_query_info_finish() to get the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="787"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24206">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24207">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24208">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24209">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24210">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24212">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24214">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_finish" c:identifier="g_file_query_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24228">Finishes an asynchronous file info query.
|
|
See g_file_query_info_async().</doc>
|
|
<source-position filename="gfile.h" line="795"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24237">#GFileInfo for given @file
|
|
or %NULL on error. Free the returned object with
|
|
g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24230">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24231">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_settable_attributes" c:identifier="g_file_query_settable_attributes" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24243">Obtain the list of settable attributes for the file.
|
|
|
|
Returns the type and full attribute name of all the attributes
|
|
that can be set on this file. This doesn't mean setting it will
|
|
always succeed though, you might get an access failure, or some
|
|
specific file may not support a specific attribute.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="951"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24261">a #GFileAttributeInfoList describing the settable attributes.
|
|
When you are done with it, release it with
|
|
g_file_attribute_info_list_unref()</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24245">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24246">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_writable_namespaces" c:identifier="g_file_query_writable_namespaces" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24267">Obtain the list of attribute namespaces where new attributes
|
|
can be created by a user. An example of this is extended
|
|
attributes (in the "xattr" namespace).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="955"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24282">a #GFileAttributeInfoList describing the writable namespaces.
|
|
When you are done with it, release it with
|
|
g_file_attribute_info_list_unref()</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24269">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24270">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read" c:identifier="g_file_read" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24288">Opens a file for reading. The result is a #GFileInputStream that
|
|
can be used to read the contents of the file.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If the file does not exist, the %G_IO_ERROR_NOT_FOUND error will be
|
|
returned. If the file is a directory, the %G_IO_ERROR_IS_DIRECTORY
|
|
error will be returned. Other errors are possible too, and depend
|
|
on what kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="658"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24306">#GFileInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24290">#GFile to read</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24291">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_async" c:identifier="g_file_read_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24311">Asynchronously opens @file for reading.
|
|
|
|
For more details, see g_file_read() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_read_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="662"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24313">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24314">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24315">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24317">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24319">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_finish" c:identifier="g_file_read_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24332">Finishes an asynchronous file read operation started with
|
|
g_file_read_async().</doc>
|
|
<source-position filename="gfile.h" line="668"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24341">a #GFileInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24334">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24335">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace" c:identifier="g_file_replace" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24346">Returns an output stream for overwriting the file, possibly
|
|
creating a backup copy of the file first. If the file doesn't exist,
|
|
it will be created.
|
|
|
|
This will try to replace the file in the safest way possible so
|
|
that any errors during the writing will not affect an already
|
|
existing copy of the file. For instance, for local files it
|
|
may write to a temporary file and then atomically rename over
|
|
the destination when the stream is closed.
|
|
|
|
By default files created are generally readable by everyone,
|
|
but if you pass #G_FILE_CREATE_PRIVATE in @flags the file
|
|
will be made readable only to the current user, to the level that
|
|
is supported on the target filesystem.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled
|
|
by triggering the cancellable object from another thread. If the
|
|
operation was cancelled, the error %G_IO_ERROR_CANCELLED will be
|
|
returned.
|
|
|
|
If you pass in a non-%NULL @etag value and @file already exists, then
|
|
this value is compared to the current entity tag of the file, and if
|
|
they differ an %G_IO_ERROR_WRONG_ETAG error is returned. This
|
|
generally means that the file has been changed since you last read
|
|
it. You can get the new etag from g_file_output_stream_get_etag()
|
|
after you've finished writing and closed the #GFileOutputStream. When
|
|
you load a new file you can use g_file_input_stream_query_info() to
|
|
get the etag of the file.
|
|
|
|
If @make_backup is %TRUE, this function will attempt to make a
|
|
backup of the current file before overwriting it. If this fails
|
|
a %G_IO_ERROR_CANT_CREATE_BACKUP error will be returned. If you
|
|
want to replace anyway, try again with @make_backup set to %FALSE.
|
|
|
|
If the file is a directory the %G_IO_ERROR_IS_DIRECTORY error will
|
|
be returned, and if the file is some other form of non-regular file
|
|
then a %G_IO_ERROR_NOT_REGULAR_FILE error will be returned. Some
|
|
file systems don't allow all file names, and may return an
|
|
%G_IO_ERROR_INVALID_FILENAME error, and if the name is to long
|
|
%G_IO_ERROR_FILENAME_TOO_LONG will be returned. Other errors are
|
|
possible too, and depend on what kind of filesystem the file is on.</doc>
|
|
<source-position filename="gfile.h" line="682"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24399">a #GFileOutputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24348">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24349">an optional [entity tag][gfile-etag]
|
|
for the current #GFile, or #NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24351">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24352">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24353">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_async" c:identifier="g_file_replace_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24404">Asynchronously overwrites the file, replacing the contents,
|
|
possibly creating a backup copy of the file first.
|
|
|
|
For more details, see g_file_replace() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_replace_finish() to get the result
|
|
of the operation.</doc>
|
|
<source-position filename="gfile.h" line="711"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24406">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24407">an [entity tag][gfile-etag] for the current #GFile,
|
|
or %NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24409">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24410">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24411">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24412">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24414">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24416">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_contents" c:identifier="g_file_replace_contents" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24430">Replaces the contents of @file with @contents of @length bytes.
|
|
|
|
If @etag is specified (not %NULL), any existing file must have that etag,
|
|
or the error %G_IO_ERROR_WRONG_ETAG will be returned.
|
|
|
|
If @make_backup is %TRUE, this function will attempt to make a backup
|
|
of @file. Internally, it uses g_file_replace(), so will try to replace the
|
|
file contents in the safest way possible. For example, atomic renames are
|
|
used when replacing local files’ contents.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
The returned @new_etag can be used to verify that the file hasn't
|
|
changed the next time it is saved over.</doc>
|
|
<source-position filename="gfile.h" line="1230"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24462">%TRUE if successful. If an error has occurred, this function
|
|
will return %FALSE and set @error appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24432">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="contents" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24433">a string containing the new contents for @file</doc>
|
|
<array length="1" zero-terminated="0" c:type="const char*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24434">the length of @contents in bytes</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24435">the old [entity-tag][gfile-etag] for the document,
|
|
or %NULL</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24437">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24438">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="new_etag" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24439">a location to a new [entity tag][gfile-etag]
|
|
for the document. This should be freed with g_free() when no longer
|
|
needed, or %NULL</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24442">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_contents_async" c:identifier="g_file_replace_contents_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24467">Starts an asynchronous replacement of @file with the given
|
|
@contents of @length bytes. @etag will replace the document's
|
|
current entity tag.
|
|
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_replace_contents_finish().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
If @make_backup is %TRUE, this function will attempt to
|
|
make a backup of @file.
|
|
|
|
Note that no copy of @content will be made, so it must stay valid
|
|
until @callback is called. See g_file_replace_contents_bytes_async()
|
|
for a #GBytes version that will automatically hold a reference to the
|
|
contents (without copying) for the duration of the call.</doc>
|
|
<source-position filename="gfile.h" line="1240"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24469">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="contents" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24470">string of contents to replace the file with</doc>
|
|
<array length="1" zero-terminated="0" c:type="const char*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24471">the length of @contents in bytes</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24472">a new [entity tag][gfile-etag] for the @file, or %NULL</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24473">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24474">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24475">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24476">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24477">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_contents_bytes_async" c:identifier="g_file_replace_contents_bytes_async" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24501">Same as g_file_replace_contents_async() but takes a #GBytes input instead.
|
|
This function will keep a ref on @contents until the operation is done.
|
|
Unlike g_file_replace_contents_async() this allows forgetting about the
|
|
content without waiting for the callback.
|
|
|
|
When this operation has completed, @callback will be called with
|
|
@user_user data, and the operation can be finalized with
|
|
g_file_replace_contents_finish().</doc>
|
|
<source-position filename="gfile.h" line="1250"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24503">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="contents" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24504">a #GBytes</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24505">a new [entity tag][gfile-etag] for the @file, or %NULL</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24506">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24507">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24508">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24509">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24510">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_contents_finish" c:identifier="g_file_replace_contents_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24525">Finishes an asynchronous replace of the given @file. See
|
|
g_file_replace_contents_async(). Sets @new_etag to the new entity
|
|
tag for the document, if present.</doc>
|
|
<source-position filename="gfile.h" line="1259"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24538">%TRUE on success, %FALSE on failure.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24527">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24528">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="new_etag" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24529">a location of a new [entity tag][gfile-etag]
|
|
for the document. This should be freed with g_free() when it is no
|
|
longer needed, or %NULL</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_finish" c:identifier="g_file_replace_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24542">Finishes an asynchronous file replace operation started with
|
|
g_file_replace_async().</doc>
|
|
<source-position filename="gfile.h" line="720"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24551">a #GFileOutputStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24544">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24545">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_readwrite" c:identifier="g_file_replace_readwrite" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24556">Returns an output stream for overwriting the file in readwrite mode,
|
|
possibly creating a backup copy of the file first. If the file doesn't
|
|
exist, it will be created.
|
|
|
|
For details about the behaviour, see g_file_replace() which does the
|
|
same thing but returns an output stream only.
|
|
|
|
Note that in many non-local file cases read and write streams are not
|
|
supported, so make sure you really need to do read and write streaming,
|
|
rather than just opening for reading or writing.</doc>
|
|
<source-position filename="gfile.h" line="754"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24578">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24558">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24559">an optional [entity tag][gfile-etag]
|
|
for the current #GFile, or #NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24561">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24562">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24563">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_readwrite_async" c:identifier="g_file_replace_readwrite_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24584">Asynchronously overwrites the file in read-write mode,
|
|
replacing the contents, possibly creating a backup copy
|
|
of the file first.
|
|
|
|
For more details, see g_file_replace_readwrite() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_replace_readwrite_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="761"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24586">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24587">an [entity tag][gfile-etag] for the current #GFile,
|
|
or %NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24589">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24590">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24591">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24592">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24594">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24596">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="replace_readwrite_finish" c:identifier="g_file_replace_readwrite_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24613">Finishes an asynchronous file replace operation started with
|
|
g_file_replace_readwrite_async().</doc>
|
|
<source-position filename="gfile.h" line="770"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24622">a #GFileIOStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24615">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24616">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="resolve_relative_path" c:identifier="g_file_resolve_relative_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24628">Resolves a relative path for @file to an absolute path.
|
|
|
|
This call does no blocking I/O.</doc>
|
|
<source-position filename="gfile.h" line="648"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24637">#GFile to the resolved path.
|
|
%NULL if @relative_path is %NULL or if @file is invalid.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24630">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="relative_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24631">a given relative path string</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute" c:identifier="g_file_set_attribute" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24643">Sets an attribute in the file with attribute name @attribute to @value.
|
|
|
|
Some attributes can be unset by setting @type to
|
|
%G_FILE_ATTRIBUTE_TYPE_INVALID and @value_p to %NULL.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="959"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24664">%TRUE if the attribute was set, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24645">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24646">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24647">The type of the attribute</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType"/>
|
|
</parameter>
|
|
<parameter name="value_p" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24648">a pointer to the value (or the pointer
|
|
itself if the type is a pointer type)</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24650">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24651">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_byte_string" c:identifier="g_file_set_attribute_byte_string" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24668">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_BYTE_STRING to @value.
|
|
If @attribute is of a different type, this operation will fail,
|
|
returning %FALSE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="993"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24686">%TRUE if the @attribute was successfully set to @value
|
|
in the @file, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24670">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24671">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24672">a string containing the attribute's new value</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24673">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24674">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_int32" c:identifier="g_file_set_attribute_int32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24691">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT32 to @value.
|
|
If @attribute is of a different type, this operation will fail.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1007"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24708">%TRUE if the @attribute was successfully set to @value
|
|
in the @file, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24693">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24694">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24695">a #gint32 containing the attribute's new value</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24696">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24697">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_int64" c:identifier="g_file_set_attribute_int64" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24713">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_INT64 to @value.
|
|
If @attribute is of a different type, this operation will fail.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1021"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24730">%TRUE if the @attribute was successfully set, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24715">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24716">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24717">a #guint64 containing the attribute's new value</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24718">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24719">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_string" c:identifier="g_file_set_attribute_string" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24734">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_STRING to @value.
|
|
If @attribute is of a different type, this operation will fail.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="986"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24751">%TRUE if the @attribute was successfully set, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24736">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24737">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24738">a string containing the attribute's value</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24739">#GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24740">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_uint32" c:identifier="g_file_set_attribute_uint32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24755">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT32 to @value.
|
|
If @attribute is of a different type, this operation will fail.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1000"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24772">%TRUE if the @attribute was successfully set to @value
|
|
in the @file, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24757">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24758">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24759">a #guint32 containing the attribute's new value</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24760">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24761">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_uint64" c:identifier="g_file_set_attribute_uint64" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24777">Sets @attribute of type %G_FILE_ATTRIBUTE_TYPE_UINT64 to @value.
|
|
If @attribute is of a different type, this operation will fail.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="1014"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24794">%TRUE if the @attribute was successfully set to @value
|
|
in the @file, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24779">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24780">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24781">a #guint64 containing the attribute's new value</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24782">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24783">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attributes_async" c:identifier="g_file_set_attributes_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24799">Asynchronously sets the attributes of @file with @info.
|
|
|
|
For more details, see g_file_set_attributes_from_info(),
|
|
which is the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_set_attributes_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="973"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24801">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24802">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24803">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24804">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24805">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24807">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24808">a #gpointer</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attributes_finish" c:identifier="g_file_set_attributes_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24821">Finishes setting an attribute started in g_file_set_attributes_async().</doc>
|
|
<source-position filename="gfile.h" line="981"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24830">%TRUE if the attributes were set correctly, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24823">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24824">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="info" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24825">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attributes_from_info" c:identifier="g_file_set_attributes_from_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24834">Tries to set all attributes in the #GFileInfo on the target
|
|
values, not stopping on the first error.
|
|
|
|
If there is any error during this operation then @error will
|
|
be set to the first error. Error on particular fields are flagged
|
|
by setting the "status" field in the attribute value to
|
|
%G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING, which means you can
|
|
also detect further errors.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="967"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24856">%FALSE if there was any error, %TRUE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24836">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24837">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24838">#GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24839">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_display_name" c:identifier="g_file_set_display_name" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24860">Renames @file to the specified display name.
|
|
|
|
The display name is converted from UTF-8 to the correct encoding
|
|
for the target filesystem if possible and the @file is renamed to this.
|
|
|
|
If you want to implement a rename operation in the user interface the
|
|
edit name (#G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME) should be used as the
|
|
initial value in the rename widget, and then the result after editing
|
|
should be passed to g_file_set_display_name().
|
|
|
|
On success the resulting converted filename is returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="847"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24884">a #GFile specifying what @file was renamed to,
|
|
or %NULL if there was an error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24862">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24863">a string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24864">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_display_name_async" c:identifier="g_file_set_display_name_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24890">Asynchronously sets the display name for a given #GFile.
|
|
|
|
For more details, see g_file_set_display_name() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_set_display_name_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="852"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24892">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24893">a string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24894">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24895">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24897">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24899">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_display_name_finish" c:identifier="g_file_set_display_name_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24912">Finishes setting a display name started with
|
|
g_file_set_display_name_async().</doc>
|
|
<source-position filename="gfile.h" line="859"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24921">a #GFile or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24914">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24915">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start_mountable" c:identifier="g_file_start_mountable" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24926">Starts a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
Using @start_operation, you can request callbacks when, for instance,
|
|
passwords are needed during authentication.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_mount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="1148"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24928">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24929">flags affecting the operation</doc>
|
|
<type name="DriveStartFlags" c:type="GDriveStartFlags"/>
|
|
</parameter>
|
|
<parameter name="start_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24930">a #GMountOperation, or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24931">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24932">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24933">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start_mountable_finish" c:identifier="g_file_start_mountable_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24951">Finishes a start operation. See g_file_start_mountable() for details.
|
|
|
|
Finish an asynchronous start operation that was started
|
|
with g_file_start_mountable().</doc>
|
|
<source-position filename="gfile.h" line="1155"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24962">%TRUE if the operation finished successfully. %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24953">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24954">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop_mountable" c:identifier="g_file_stop_mountable" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24968">Stops a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_stop_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="1159"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24970">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24971">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24972">a #GMountOperation,
|
|
or %NULL to avoid user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24974">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24976">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24978">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop_mountable_finish" c:identifier="g_file_stop_mountable_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24994">Finishes an stop operation, see g_file_stop_mountable() for details.
|
|
|
|
Finish an asynchronous stop operation that was started
|
|
with g_file_stop_mountable().</doc>
|
|
<source-position filename="gfile.h" line="1166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25005">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24996">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24997">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="supports_thread_contexts" c:identifier="g_file_supports_thread_contexts" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25011">Checks if @file supports
|
|
[thread-default contexts][g-main-context-push-thread-default-context].
|
|
If this returns %FALSE, you cannot perform asynchronous operations on
|
|
@file in a thread that has a thread-default context.</doc>
|
|
<source-position filename="gfile.h" line="1265"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25020">Whether or not @file supports thread-default contexts.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25013">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="trash" c:identifier="g_file_trash" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25025">Sends @file to the "Trashcan", if possible. This is similar to
|
|
deleting it, but the user can recover it before emptying the trashcan.
|
|
Not all file systems support trashing, so this call can return the
|
|
%G_IO_ERROR_NOT_SUPPORTED error.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gfile.h" line="880"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25041">%TRUE on successful trash, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25027">#GFile to send to trash</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25028">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="trash_async" c:identifier="g_file_trash_async" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25045">Asynchronously sends @file to the Trash location, if possible.</doc>
|
|
<source-position filename="gfile.h" line="885"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25047">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25048">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25049">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25051">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25053">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="trash_finish" c:identifier="g_file_trash_finish" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25061">Finishes an asynchronous file trashing operation, started with
|
|
g_file_trash_async().</doc>
|
|
<source-position filename="gfile.h" line="892"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25070">%TRUE on successful trash, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25063">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25064">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount_mountable" c:identifier="g_file_unmount_mountable" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25075">Unmounts a file of type G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_unmount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_unmount_mountable_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="1050"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25077">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25078">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25079">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25081">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25083">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount_mountable_finish" c:identifier="g_file_unmount_mountable_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25099">Finishes an unmount operation, see g_file_unmount_mountable() for details.
|
|
|
|
Finish an asynchronous unmount operation that was started
|
|
with g_file_unmount_mountable().</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_unmount_mountable_with_operation_finish()
|
|
instead.</doc-deprecated>
|
|
<source-position filename="gfile.h" line="1057"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25110">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25101">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25102">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount_mountable_with_operation" c:identifier="g_file_unmount_mountable_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25117">Unmounts a file of type #G_FILE_TYPE_MOUNTABLE.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_file_unmount_mountable_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gfile.h" line="1061"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25119">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25120">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25121">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25123">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25125">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25127">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount_mountable_with_operation_finish" c:identifier="g_file_unmount_mountable_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25143">Finishes an unmount operation,
|
|
see g_file_unmount_mountable_with_operation() for details.
|
|
|
|
Finish an asynchronous unmount operation that was started
|
|
with g_file_unmount_mountable_with_operation().</doc>
|
|
<source-position filename="gfile.h" line="1068"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25155">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25145">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25146">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="FileAttributeInfo" c:type="GFileAttributeInfo">
|
|
<doc xml:space="preserve" filename="gfileattribute.h" line="32">Information about a specific attribute.</doc>
|
|
<source-position filename="gfileattribute.h" line="45"/>
|
|
<field name="name" writable="1">
|
|
<doc xml:space="preserve" filename="gfileattribute.h" line="34">the name of the attribute.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</field>
|
|
<field name="type" writable="1">
|
|
<doc xml:space="preserve" filename="gfileattribute.h" line="35">the #GFileAttributeType type of the attribute.</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType"/>
|
|
</field>
|
|
<field name="flags" writable="1">
|
|
<doc xml:space="preserve" filename="gfileattribute.h" line="36">a set of #GFileAttributeInfoFlags.</doc>
|
|
<type name="FileAttributeInfoFlags" c:type="GFileAttributeInfoFlags"/>
|
|
</field>
|
|
</record>
|
|
<bitfield name="FileAttributeInfoFlags" glib:type-name="GFileAttributeInfoFlags" glib:get-type="g_file_attribute_info_flags_get_type" c:type="GFileAttributeInfoFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="147">Flags specifying the behaviour of an attribute.</doc>
|
|
<member name="none" value="0" c:identifier="G_FILE_ATTRIBUTE_INFO_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="149">no flags set.</doc>
|
|
</member>
|
|
<member name="copy_with_file" value="1" c:identifier="G_FILE_ATTRIBUTE_INFO_COPY_WITH_FILE" glib:nick="copy-with-file">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="150">copy the attribute values when the file is copied.</doc>
|
|
</member>
|
|
<member name="copy_when_moved" value="2" c:identifier="G_FILE_ATTRIBUTE_INFO_COPY_WHEN_MOVED" glib:nick="copy-when-moved">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="151">copy the attribute values when the file is moved.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="FileAttributeInfoList" c:type="GFileAttributeInfoList" glib:type-name="GFileAttributeInfoList" glib:get-type="g_file_attribute_info_list_get_type" c:symbol-prefix="file_attribute_info_list">
|
|
<doc xml:space="preserve" filename="gfileattribute.h" line="47">Acts as a lightweight registry for possible valid file attributes.
|
|
The registry stores Key-Value pair formats as #GFileAttributeInfos.</doc>
|
|
<source-position filename="gfileattribute.h" line="59"/>
|
|
<field name="infos" writable="1">
|
|
<doc xml:space="preserve" filename="gfileattribute.h" line="49">an array of #GFileAttributeInfos.</doc>
|
|
<type name="FileAttributeInfo" c:type="GFileAttributeInfo*"/>
|
|
</field>
|
|
<field name="n_infos" writable="1">
|
|
<doc xml:space="preserve" filename="gfileattribute.h" line="50">the number of values in the array.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</field>
|
|
<constructor name="new" c:identifier="g_file_attribute_info_list_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20877">Creates a new file attribute info list.</doc>
|
|
<source-position filename="gfileattribute.h" line="66"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20882">a #GFileAttributeInfoList.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="add" c:identifier="g_file_attribute_info_list_add">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20843">Adds a new attribute with @name to the @list, setting
|
|
its @type and @flags.</doc>
|
|
<source-position filename="gfileattribute.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20845">a #GFileAttributeInfoList.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20846">the name of the attribute to add.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20847">the #GFileAttributeType for the attribute.</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20848">#GFileAttributeInfoFlags for the attribute.</doc>
|
|
<type name="FileAttributeInfoFlags" c:type="GFileAttributeInfoFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dup" c:identifier="g_file_attribute_info_list_dup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20855">Makes a duplicate of a file attribute info list.</doc>
|
|
<source-position filename="gfileattribute.h" line="72"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20861">a copy of the given @list.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20857">a #GFileAttributeInfoList to duplicate.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup" c:identifier="g_file_attribute_info_list_lookup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20865">Gets the file attribute with the name @name from @list.</doc>
|
|
<source-position filename="gfileattribute.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20872">a #GFileAttributeInfo for the @name, or %NULL if an
|
|
attribute isn't found.</doc>
|
|
<type name="FileAttributeInfo" c:type="const GFileAttributeInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20867">a #GFileAttributeInfoList.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20868">the name of the attribute to look up.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_file_attribute_info_list_ref">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20886">References a file attribute info list.</doc>
|
|
<source-position filename="gfileattribute.h" line="68"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20892">#GFileAttributeInfoList or %NULL on error.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20888">a #GFileAttributeInfoList to reference.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_file_attribute_info_list_unref">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20896">Removes a reference from the given @list. If the reference count
|
|
falls to zero, the @list is deleted.</doc>
|
|
<source-position filename="gfileattribute.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20898">The #GFileAttributeInfoList to unreference.</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<record name="FileAttributeMatcher" c:type="GFileAttributeMatcher" glib:type-name="GFileAttributeMatcher" glib:get-type="g_file_attribute_matcher_get_type" c:symbol-prefix="file_attribute_matcher">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="87">Determines if a string matches a file attribute.</doc>
|
|
<source-position filename="giotypes.h" line="92"/>
|
|
<constructor name="new" c:identifier="g_file_attribute_matcher_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20958">Creates a new file attribute matcher, which matches attributes
|
|
against a given string. #GFileAttributeMatchers are reference
|
|
counted structures, and are created with a reference count of 1. If
|
|
the number of references falls to 0, the #GFileAttributeMatcher is
|
|
automatically destroyed.
|
|
|
|
The @attribute string should be formatted with specific keys separated
|
|
from namespaces with a double colon. Several "namespace::key" strings may be
|
|
concatenated with a single comma (e.g. "standard::type,standard::is-hidden").
|
|
The wildcard "*" may be used to match all keys and namespaces, or
|
|
"namespace::*" will match all keys in a given namespace.
|
|
|
|
## Examples of file attribute matcher strings and results
|
|
|
|
- `"*"`: matches all attributes.
|
|
- `"standard::is-hidden"`: matches only the key is-hidden in the
|
|
standard namespace.
|
|
- `"standard::type,unix::*"`: matches the type key in the standard
|
|
namespace and all keys in the unix namespace.</doc>
|
|
<source-position filename="gfileinfo.h" line="1120"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20982">a #GFileAttributeMatcher</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20960">an attribute string to match.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="enumerate_namespace" c:identifier="g_file_attribute_matcher_enumerate_namespace">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20905">Checks if the matcher will match all of the keys in a given namespace.
|
|
This will always return %TRUE if a wildcard character is in use (e.g. if
|
|
matcher was created with "standard::*" and @ns is "standard", or if matcher was created
|
|
using "*" and namespace is anything.)
|
|
|
|
TODO: this is awkwardly worded.</doc>
|
|
<source-position filename="gfileinfo.h" line="1135"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20917">%TRUE if the matcher matches all of the entries
|
|
in the given @ns, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20907">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
<parameter name="ns" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20908">a string containing a file attribute namespace.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="enumerate_next" c:identifier="g_file_attribute_matcher_enumerate_next">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20922">Gets the next matched attribute from a #GFileAttributeMatcher.</doc>
|
|
<source-position filename="gfileinfo.h" line="1138"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20928">a string containing the next attribute or %NULL if
|
|
no more attribute exist.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20924">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="matches" c:identifier="g_file_attribute_matcher_matches">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20933">Checks if an attribute will be matched by an attribute matcher. If
|
|
the matcher was created with the "*" matching string, this function
|
|
will always return %TRUE.</doc>
|
|
<source-position filename="gfileinfo.h" line="1129"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20942">%TRUE if @attribute matches @matcher. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20935">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20936">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="matches_only" c:identifier="g_file_attribute_matcher_matches_only">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20946">Checks if a attribute matcher only matches a given attribute. Always
|
|
returns %FALSE if "*" was used when creating the matcher.</doc>
|
|
<source-position filename="gfileinfo.h" line="1132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20954">%TRUE if the matcher only matches @attribute. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20948">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20949">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_file_attribute_matcher_ref">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20986">References a file attribute matcher.</doc>
|
|
<source-position filename="gfileinfo.h" line="1122"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20992">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20988">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="subtract" c:identifier="g_file_attribute_matcher_subtract">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20996">Subtracts all attributes of @subtract from @matcher and returns
|
|
a matcher that supports those attributes.
|
|
|
|
Note that currently it is not possible to remove a single
|
|
attribute when the @matcher matches the whole namespace - or remove
|
|
a namespace or attribute when the matcher matches everything. This
|
|
is a limitation of the current implementation, but may be fixed
|
|
in the future.</doc>
|
|
<source-position filename="gfileinfo.h" line="1126"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21010">A file attribute matcher matching all attributes of
|
|
@matcher that are not matched by @subtract</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20998">Matcher to subtract from</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
<parameter name="subtract" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20999">The matcher to subtract</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_string" c:identifier="g_file_attribute_matcher_to_string" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21015">Prints what the matcher is matching against. The format will be
|
|
equal to the format passed to g_file_attribute_matcher_new().
|
|
The output however, might not be identical, as the matcher may
|
|
decide to use a different order or omit needless parts.</doc>
|
|
<source-position filename="gfileinfo.h" line="1140"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21024">a string describing the attributes the matcher matches
|
|
against or %NULL if @matcher was %NULL.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21017">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_file_attribute_matcher_unref">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21030">Unreferences @matcher. If the reference count falls below 1,
|
|
the @matcher is automatically freed.</doc>
|
|
<source-position filename="gfileinfo.h" line="1124"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="matcher" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21032">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<enumeration name="FileAttributeStatus" glib:type-name="GFileAttributeStatus" glib:get-type="g_file_attribute_status_get_type" c:type="GFileAttributeStatus">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="162">Used by g_file_set_attributes_from_info() when setting file attributes.</doc>
|
|
<member name="unset" value="0" c:identifier="G_FILE_ATTRIBUTE_STATUS_UNSET" glib:nick="unset">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="164">Attribute value is unset (empty).</doc>
|
|
</member>
|
|
<member name="set" value="1" c:identifier="G_FILE_ATTRIBUTE_STATUS_SET" glib:nick="set">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="165">Attribute value is set.</doc>
|
|
</member>
|
|
<member name="error_setting" value="2" c:identifier="G_FILE_ATTRIBUTE_STATUS_ERROR_SETTING" glib:nick="error-setting">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="166">Indicates an error in setting the value.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<enumeration name="FileAttributeType" glib:type-name="GFileAttributeType" glib:get-type="g_file_attribute_type_get_type" c:type="GFileAttributeType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="118">The data types for file attributes.</doc>
|
|
<member name="invalid" value="0" c:identifier="G_FILE_ATTRIBUTE_TYPE_INVALID" glib:nick="invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="120">indicates an invalid or uninitalized type.</doc>
|
|
</member>
|
|
<member name="string" value="1" c:identifier="G_FILE_ATTRIBUTE_TYPE_STRING" glib:nick="string">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="121">a null terminated UTF8 string.</doc>
|
|
</member>
|
|
<member name="byte_string" value="2" c:identifier="G_FILE_ATTRIBUTE_TYPE_BYTE_STRING" glib:nick="byte-string">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="122">a zero terminated string of non-zero bytes.</doc>
|
|
</member>
|
|
<member name="boolean" value="3" c:identifier="G_FILE_ATTRIBUTE_TYPE_BOOLEAN" glib:nick="boolean">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="123">a boolean value.</doc>
|
|
</member>
|
|
<member name="uint32" value="4" c:identifier="G_FILE_ATTRIBUTE_TYPE_UINT32" glib:nick="uint32">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="124">an unsigned 4-byte/32-bit integer.</doc>
|
|
</member>
|
|
<member name="int32" value="5" c:identifier="G_FILE_ATTRIBUTE_TYPE_INT32" glib:nick="int32">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="125">a signed 4-byte/32-bit integer.</doc>
|
|
</member>
|
|
<member name="uint64" value="6" c:identifier="G_FILE_ATTRIBUTE_TYPE_UINT64" glib:nick="uint64">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="126">an unsigned 8-byte/64-bit integer.</doc>
|
|
</member>
|
|
<member name="int64" value="7" c:identifier="G_FILE_ATTRIBUTE_TYPE_INT64" glib:nick="int64">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="127">a signed 8-byte/64-bit integer.</doc>
|
|
</member>
|
|
<member name="object" value="8" c:identifier="G_FILE_ATTRIBUTE_TYPE_OBJECT" glib:nick="object">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="128">a #GObject.</doc>
|
|
</member>
|
|
<member name="stringv" value="9" c:identifier="G_FILE_ATTRIBUTE_TYPE_STRINGV" glib:nick="stringv">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="129">a %NULL terminated char **. Since 2.22</doc>
|
|
</member>
|
|
</enumeration>
|
|
<bitfield name="FileCopyFlags" glib:type-name="GFileCopyFlags" glib:get-type="g_file_copy_flags_get_type" c:type="GFileCopyFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="300">Flags used when copying or moving files.</doc>
|
|
<member name="none" value="0" c:identifier="G_FILE_COPY_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="302">No flags set.</doc>
|
|
</member>
|
|
<member name="overwrite" value="1" c:identifier="G_FILE_COPY_OVERWRITE" glib:nick="overwrite">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="303">Overwrite any existing files</doc>
|
|
</member>
|
|
<member name="backup" value="2" c:identifier="G_FILE_COPY_BACKUP" glib:nick="backup">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="304">Make a backup of any existing files.</doc>
|
|
</member>
|
|
<member name="nofollow_symlinks" value="4" c:identifier="G_FILE_COPY_NOFOLLOW_SYMLINKS" glib:nick="nofollow-symlinks">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="305">Don't follow symlinks.</doc>
|
|
</member>
|
|
<member name="all_metadata" value="8" c:identifier="G_FILE_COPY_ALL_METADATA" glib:nick="all-metadata">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="306">Copy all file metadata instead of just default set used for copy (see #GFileInfo).</doc>
|
|
</member>
|
|
<member name="no_fallback_for_move" value="16" c:identifier="G_FILE_COPY_NO_FALLBACK_FOR_MOVE" glib:nick="no-fallback-for-move">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="307">Don't use copy and delete fallback if native move not supported.</doc>
|
|
</member>
|
|
<member name="target_default_perms" value="32" c:identifier="G_FILE_COPY_TARGET_DEFAULT_PERMS" glib:nick="target-default-perms">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="308">Leaves target file with default perms, instead of setting the source file perms.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<bitfield name="FileCreateFlags" glib:type-name="GFileCreateFlags" glib:get-type="g_file_create_flags_get_type" c:type="GFileCreateFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="190">Flags used when an operation may create a file.</doc>
|
|
<member name="none" value="0" c:identifier="G_FILE_CREATE_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="192">No flags set.</doc>
|
|
</member>
|
|
<member name="private" value="1" c:identifier="G_FILE_CREATE_PRIVATE" glib:nick="private">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="193">Create a file that can only be
|
|
accessed by the current user.</doc>
|
|
</member>
|
|
<member name="replace_destination" value="2" c:identifier="G_FILE_CREATE_REPLACE_DESTINATION" glib:nick="replace-destination">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="195">Replace the destination
|
|
as if it didn't exist before. Don't try to keep any old
|
|
permissions, replace instead of following links. This
|
|
is generally useful if you're doing a "copy over"
|
|
rather than a "save new version of" replace operation.
|
|
You can think of it as "unlink destination" before
|
|
writing to it, although the implementation may not
|
|
be exactly like that. Since 2.20</doc>
|
|
</member>
|
|
</bitfield>
|
|
<interface name="FileDescriptorBased" c:symbol-prefix="file_descriptor_based" c:type="GFileDescriptorBased" version="2.24" glib:type-name="GFileDescriptorBased" glib:get-type="g_file_descriptor_based_get_type" glib:type-struct="FileDescriptorBasedIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6332">#GFileDescriptorBased is implemented by streams (implementations of
|
|
#GInputStream or #GOutputStream) that are based on file descriptors.
|
|
|
|
Note that `<gio/gfiledescriptorbased.h>` belongs to the UNIX-specific
|
|
GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config
|
|
file when using it.</doc>
|
|
<source-position filename="gfiledescriptorbased.h" line="54"/>
|
|
<virtual-method name="get_fd" invoker="get_fd" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21376">Gets the underlying file descriptor.</doc>
|
|
<source-position filename="gfiledescriptorbased.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21382">The file descriptor</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="fd_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21378">a #GFileDescriptorBased.</doc>
|
|
<type name="FileDescriptorBased" c:type="GFileDescriptorBased*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_fd" c:identifier="g_file_descriptor_based_get_fd" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21376">Gets the underlying file descriptor.</doc>
|
|
<source-position filename="gfiledescriptorbased.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21382">The file descriptor</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="fd_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21378">a #GFileDescriptorBased.</doc>
|
|
<type name="FileDescriptorBased" c:type="GFileDescriptorBased*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="FileDescriptorBasedIface" c:type="GFileDescriptorBasedIface" glib:is-gtype-struct-for="FileDescriptorBased">
|
|
<doc xml:space="preserve" filename="gfiledescriptorbased.h" line="41">An interface for file descriptor based io objects.</doc>
|
|
<source-position filename="gfiledescriptorbased.h" line="54"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gfiledescriptorbased.h" line="43">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_fd">
|
|
<callback name="get_fd">
|
|
<source-position filename="gfiledescriptorbased.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21382">The file descriptor</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="fd_based" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21378">a #GFileDescriptorBased.</doc>
|
|
<type name="FileDescriptorBased" c:type="GFileDescriptorBased*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="FileEnumerator" c:symbol-prefix="file_enumerator" c:type="GFileEnumerator" parent="GObject.Object" glib:type-name="GFileEnumerator" glib:get-type="g_file_enumerator_get_type" glib:type-struct="FileEnumeratorClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6349">#GFileEnumerator allows you to operate on a set of #GFiles,
|
|
returning a #GFileInfo structure for each file enumerated (e.g.
|
|
g_file_enumerate_children() will return a #GFileEnumerator for each
|
|
of the children within a directory).
|
|
|
|
To get the next file's information from a #GFileEnumerator, use
|
|
g_file_enumerator_next_file() or its asynchronous version,
|
|
g_file_enumerator_next_files_async(). Note that the asynchronous
|
|
version will return a list of #GFileInfos, whereas the
|
|
synchronous will only return the next file in the enumerator.
|
|
|
|
The ordering of returned files is unspecified for non-Unix
|
|
platforms; for more information, see g_dir_read_name(). On Unix,
|
|
when operating on local files, returned files will be sorted by
|
|
inode number. Effectively you can assume that the ordering of
|
|
returned files will be stable between successive calls (and
|
|
applications) assuming the directory is unchanged.
|
|
|
|
If your application needs a specific ordering, such as by name or
|
|
modification time, you will have to implement that in your
|
|
application code.
|
|
|
|
To close a #GFileEnumerator, use g_file_enumerator_close(), or
|
|
its asynchronous version, g_file_enumerator_close_async(). Once
|
|
a #GFileEnumerator is closed, no further actions may be performed
|
|
on it, and it should be freed with g_object_unref().</doc>
|
|
<source-position filename="gfileenumerator.h" line="95"/>
|
|
<virtual-method name="close_async" invoker="close_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21581">Asynchronously closes the file enumerator.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in
|
|
g_file_enumerator_close_finish().</doc>
|
|
<source-position filename="gfileenumerator.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21583">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21584">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21585">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21586">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21587">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_finish" invoker="close_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21598">Finishes closing a file enumerator, started from g_file_enumerator_close_async().
|
|
|
|
If the file enumerator was already closed when g_file_enumerator_close_async()
|
|
was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
|
|
return %FALSE. If the file enumerator had pending operation when the close
|
|
operation was started, then this function will report %G_IO_ERROR_PENDING, and
|
|
return %FALSE. If @cancellable was not %NULL, then the operation may have been
|
|
cancelled by triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
|
|
returned.</doc>
|
|
<source-position filename="gfileenumerator.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21616">%TRUE if the close operation has finished successfully.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21600">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21601">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_fn" throws="1">
|
|
<source-position filename="gfileenumerator.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="next_file" invoker="next_file" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21724">Returns information for the next file in the enumerated object.
|
|
Will block until the information is available. The #GFileInfo
|
|
returned from this function will contain attributes that match the
|
|
attribute string that was passed when the #GFileEnumerator was created.
|
|
|
|
See the documentation of #GFileEnumerator for information about the
|
|
order of returned files.
|
|
|
|
On error, returns %NULL and sets @error to the error. If the
|
|
enumerator is at the end, %NULL will be returned and @error will
|
|
be unset.</doc>
|
|
<source-position filename="gfileenumerator.h" line="61"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21742">A #GFileInfo or %NULL on error
|
|
or end of enumerator. Free the returned object with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21726">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21727">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="next_files_async" invoker="next_files_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21748">Request information for a number of files from the enumerator asynchronously.
|
|
When all i/o for the operation is finished the @callback will be called with
|
|
the requested information.
|
|
|
|
See the documentation of #GFileEnumerator for information about the
|
|
order of returned files.
|
|
|
|
The callback can be called with less than @num_files files in case of error
|
|
or at the end of the enumerator. In case of a partial error the callback will
|
|
be called with any succeeding items and no error, and on the next request the
|
|
error will be reported. If a request is cancelled the callback will be called
|
|
with %G_IO_ERROR_CANCELLED.
|
|
|
|
During an async request no other sync and async calls are allowed, and will
|
|
result in %G_IO_ERROR_PENDING errors.
|
|
|
|
Any outstanding i/o request with higher priority (lower numerical value) will
|
|
be executed before an outstanding request with lower priority. Default
|
|
priority is %G_PRIORITY_DEFAULT.</doc>
|
|
<source-position filename="gfileenumerator.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21750">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="num_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21751">the number of file info objects to request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21752">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21753">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21754">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21755">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="next_files_finish" invoker="next_files_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21779">Finishes the asynchronous operation started with g_file_enumerator_next_files_async().</doc>
|
|
<source-position filename="gfileenumerator.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21788">a #GList of #GFileInfos. You must free the list with
|
|
g_list_free() and unref the infos with g_object_unref() when you're
|
|
done with them.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="FileInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21781">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21782">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="close" c:identifier="g_file_enumerator_close" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21564">Releases all resources used by this enumerator, making the
|
|
enumerator return %G_IO_ERROR_CLOSED on all calls.
|
|
|
|
This will be automatically called when the last reference
|
|
is dropped, but you might want to call this function to make
|
|
sure resources are released as early as possible.</doc>
|
|
<source-position filename="gfileenumerator.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21577">#TRUE on success or #FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21566">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21567">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_async" c:identifier="g_file_enumerator_close_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21581">Asynchronously closes the file enumerator.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned in
|
|
g_file_enumerator_close_finish().</doc>
|
|
<source-position filename="gfileenumerator.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21583">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21584">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21585">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21586">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21587">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_finish" c:identifier="g_file_enumerator_close_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21598">Finishes closing a file enumerator, started from g_file_enumerator_close_async().
|
|
|
|
If the file enumerator was already closed when g_file_enumerator_close_async()
|
|
was called, then this function will report %G_IO_ERROR_CLOSED in @error, and
|
|
return %FALSE. If the file enumerator had pending operation when the close
|
|
operation was started, then this function will report %G_IO_ERROR_PENDING, and
|
|
return %FALSE. If @cancellable was not %NULL, then the operation may have been
|
|
cancelled by triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %FALSE will be
|
|
returned.</doc>
|
|
<source-position filename="gfileenumerator.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21616">%TRUE if the close operation has finished successfully.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21600">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21601">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_child" c:identifier="g_file_enumerator_get_child" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21620">Return a new #GFile which refers to the file named by @info in the source
|
|
directory of @enumerator. This function is primarily intended to be used
|
|
inside loops with g_file_enumerator_next_file().
|
|
|
|
This is a convenience method that's equivalent to:
|
|
|[<!-- language="C" -->
|
|
gchar *name = g_file_info_get_name (info);
|
|
GFile *child = g_file_get_child (g_file_enumerator_get_container (enumr),
|
|
name);
|
|
]|</doc>
|
|
<source-position filename="gfileenumerator.h" line="139"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21637">a #GFile for the #GFileInfo passed it.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21622">a #GFileEnumerator</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21623">a #GFileInfo gotten from g_file_enumerator_next_file()
|
|
or the async equivalents.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_container" c:identifier="g_file_enumerator_get_container" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21642">Get the #GFile container which is being enumerated.</doc>
|
|
<source-position filename="gfileenumerator.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21648">the #GFile which is being enumerated.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21644">a #GFileEnumerator</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_pending" c:identifier="g_file_enumerator_has_pending">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21653">Checks if the file enumerator has pending operations.</doc>
|
|
<source-position filename="gfileenumerator.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21659">%TRUE if the @enumerator has pending operations.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21655">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_closed" c:identifier="g_file_enumerator_is_closed">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21663">Checks if the file enumerator has been closed.</doc>
|
|
<source-position filename="gfileenumerator.h" line="130"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21669">%TRUE if the @enumerator is closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21665">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="iterate" c:identifier="g_file_enumerator_iterate" version="2.44" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21673">This is a version of g_file_enumerator_next_file() that's easier to
|
|
use correctly from C programs. With g_file_enumerator_next_file(),
|
|
the gboolean return value signifies "end of iteration or error", which
|
|
requires allocation of a temporary #GError.
|
|
|
|
In contrast, with this function, a %FALSE return from
|
|
g_file_enumerator_iterate() *always* means
|
|
"error". End of iteration is signaled by @out_info or @out_child being %NULL.
|
|
|
|
Another crucial difference is that the references for @out_info and
|
|
@out_child are owned by @direnum (they are cached as hidden
|
|
properties). You must not unref them in your own code. This makes
|
|
memory management significantly easier for C code in combination
|
|
with loops.
|
|
|
|
Finally, this function optionally allows retrieving a #GFile as
|
|
well.
|
|
|
|
You must specify at least one of @out_info or @out_child.
|
|
|
|
The code pattern for correctly using g_file_enumerator_iterate() from C
|
|
is:
|
|
|
|
|[
|
|
direnum = g_file_enumerate_children (file, ...);
|
|
while (TRUE)
|
|
{
|
|
GFileInfo *info;
|
|
if (!g_file_enumerator_iterate (direnum, &info, NULL, cancellable, error))
|
|
goto out;
|
|
if (!info)
|
|
break;
|
|
... do stuff with "info"; do not unref it! ...
|
|
}
|
|
|
|
out:
|
|
g_object_unref (direnum); // Note: frees the last @info
|
|
]|</doc>
|
|
<source-position filename="gfileenumerator.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="direnum" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21675">an open #GFileEnumerator</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_info" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21676">Output location for the next #GFileInfo, or %NULL</doc>
|
|
<type name="FileInfo" c:type="GFileInfo**"/>
|
|
</parameter>
|
|
<parameter name="out_child" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21677">Output location for the next #GFile, or %NULL</doc>
|
|
<type name="File" c:type="GFile**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21678">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="next_file" c:identifier="g_file_enumerator_next_file" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21724">Returns information for the next file in the enumerated object.
|
|
Will block until the information is available. The #GFileInfo
|
|
returned from this function will contain attributes that match the
|
|
attribute string that was passed when the #GFileEnumerator was created.
|
|
|
|
See the documentation of #GFileEnumerator for information about the
|
|
order of returned files.
|
|
|
|
On error, returns %NULL and sets @error to the error. If the
|
|
enumerator is at the end, %NULL will be returned and @error will
|
|
be unset.</doc>
|
|
<source-position filename="gfileenumerator.h" line="101"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21742">A #GFileInfo or %NULL on error
|
|
or end of enumerator. Free the returned object with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21726">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21727">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="next_files_async" c:identifier="g_file_enumerator_next_files_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21748">Request information for a number of files from the enumerator asynchronously.
|
|
When all i/o for the operation is finished the @callback will be called with
|
|
the requested information.
|
|
|
|
See the documentation of #GFileEnumerator for information about the
|
|
order of returned files.
|
|
|
|
The callback can be called with less than @num_files files in case of error
|
|
or at the end of the enumerator. In case of a partial error the callback will
|
|
be called with any succeeding items and no error, and on the next request the
|
|
error will be reported. If a request is cancelled the callback will be called
|
|
with %G_IO_ERROR_CANCELLED.
|
|
|
|
During an async request no other sync and async calls are allowed, and will
|
|
result in %G_IO_ERROR_PENDING errors.
|
|
|
|
Any outstanding i/o request with higher priority (lower numerical value) will
|
|
be executed before an outstanding request with lower priority. Default
|
|
priority is %G_PRIORITY_DEFAULT.</doc>
|
|
<source-position filename="gfileenumerator.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21750">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="num_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21751">the number of file info objects to request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21752">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21753">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21754">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21755">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="next_files_finish" c:identifier="g_file_enumerator_next_files_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21779">Finishes the asynchronous operation started with g_file_enumerator_next_files_async().</doc>
|
|
<source-position filename="gfileenumerator.h" line="116"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21788">a #GList of #GFileInfos. You must free the list with
|
|
g_list_free() and unref the infos with g_object_unref() when you're
|
|
done with them.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="FileInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21781">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21782">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pending" c:identifier="g_file_enumerator_set_pending">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21794">Sets the file enumerator as having pending operations.</doc>
|
|
<source-position filename="gfileenumerator.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21796">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="pending" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21797">a boolean value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="container" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="File"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="FileEnumeratorPrivate" c:type="GFileEnumeratorPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="FileEnumeratorClass" c:type="GFileEnumeratorClass" glib:is-gtype-struct-for="FileEnumerator">
|
|
<source-position filename="gfileenumerator.h" line="95"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="next_file">
|
|
<callback name="next_file" throws="1">
|
|
<source-position filename="gfileenumerator.h" line="61"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21742">A #GFileInfo or %NULL on error
|
|
or end of enumerator. Free the returned object with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21726">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21727">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_fn">
|
|
<callback name="close_fn" throws="1">
|
|
<source-position filename="gfileenumerator.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="next_files_async">
|
|
<callback name="next_files_async">
|
|
<source-position filename="gfileenumerator.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21750">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="num_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21751">the number of file info objects to request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21752">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21753">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21754">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21755">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="next_files_finish">
|
|
<callback name="next_files_finish" throws="1">
|
|
<source-position filename="gfileenumerator.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21788">a #GList of #GFileInfos. You must free the list with
|
|
g_list_free() and unref the infos with g_object_unref() when you're
|
|
done with them.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="FileInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21781">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21782">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_async">
|
|
<callback name="close_async">
|
|
<source-position filename="gfileenumerator.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21583">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21584">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21585">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21586">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21587">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_finish">
|
|
<callback name="close_finish" throws="1">
|
|
<source-position filename="gfileenumerator.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21616">%TRUE if the close operation has finished successfully.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21600">a #GFileEnumerator.</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21601">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfileenumerator.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfileenumerator.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfileenumerator.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gfileenumerator.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gfileenumerator.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gfileenumerator.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved7" introspectable="0">
|
|
<callback name="_g_reserved7">
|
|
<source-position filename="gfileenumerator.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="FileEnumeratorPrivate" c:type="GFileEnumeratorPrivate" disguised="1">
|
|
<source-position filename="gfileenumerator.h" line="45"/>
|
|
</record>
|
|
<class name="FileIOStream" c:symbol-prefix="file_io_stream" c:type="GFileIOStream" version="2.22" parent="IOStream" glib:type-name="GFileIOStream" glib:get-type="g_file_io_stream_get_type" glib:type-struct="FileIOStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6445">GFileIOStream provides io streams that both read and write to the same
|
|
file handle.
|
|
|
|
GFileIOStream implements #GSeekable, which allows the io
|
|
stream to jump to arbitrary positions in the file and to truncate
|
|
the file, provided the filesystem of the file supports these
|
|
operations.
|
|
|
|
To find the position of a file io stream, use
|
|
g_seekable_tell().
|
|
|
|
To find out if a file io stream supports seeking, use g_seekable_can_seek().
|
|
To position a file io stream, use g_seekable_seek().
|
|
To find out if a file io stream supports truncating, use
|
|
g_seekable_can_truncate(). To truncate a file io
|
|
stream, use g_seekable_truncate().
|
|
|
|
The default implementation of all the #GFileIOStream operations
|
|
and the implementation of #GSeekable just call into the same operations
|
|
on the output stream.</doc>
|
|
<source-position filename="gfileiostream.h" line="95"/>
|
|
<implements name="Seekable"/>
|
|
<virtual-method name="can_seek">
|
|
<source-position filename="gfileiostream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_truncate">
|
|
<source-position filename="gfileiostream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_etag" invoker="get_etag" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22930">Gets the entity tag for the file when it has been written.
|
|
This must be called after the stream has been written
|
|
and closed, as the etag can change while writing.</doc>
|
|
<source-position filename="gfileiostream.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22938">the entity tag for the stream.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22932">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info" invoker="query_info" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22943">Queries a file io stream for the given @attributes.
|
|
This function blocks while querying the stream. For the asynchronous
|
|
version of this function, see g_file_io_stream_query_info_async().
|
|
While the stream is blocked, the stream will set the pending flag
|
|
internally, and any other operations on the stream will fail with
|
|
%G_IO_ERROR_PENDING.
|
|
|
|
Can fail if the stream was already closed (with @error being set to
|
|
%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
|
|
set to %G_IO_ERROR_PENDING), or if querying info is not supported for
|
|
the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I
|
|
all cases of failure, %NULL will be returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
|
|
be returned.</doc>
|
|
<source-position filename="gfileiostream.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22968">a #GFileInfo for the @stream, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22945">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22946">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22947">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_async" invoker="query_info_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22973">Asynchronously queries the @stream for a #GFileInfo. When completed,
|
|
@callback will be called with a #GAsyncResult which can be used to
|
|
finish the operation with g_file_io_stream_query_info_finish().
|
|
|
|
For the synchronous version of this function, see
|
|
g_file_io_stream_query_info().</doc>
|
|
<source-position filename="gfileiostream.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22975">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22976">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22977">the [I/O priority][gio-GIOScheduler] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22978">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22979">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22980">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_finish" invoker="query_info_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22993">Finalizes the asynchronous query started
|
|
by g_file_io_stream_query_info_async().</doc>
|
|
<source-position filename="gfileiostream.h" line="84"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23002">A #GFileInfo for the finished query.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22995">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22996">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="seek" throws="1">
|
|
<source-position filename="gfileiostream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="tell">
|
|
<source-position filename="gfileiostream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="truncate_fn" throws="1">
|
|
<source-position filename="gfileiostream.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_etag" c:identifier="g_file_io_stream_get_etag" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22930">Gets the entity tag for the file when it has been written.
|
|
This must be called after the stream has been written
|
|
and closed, as the etag can change while writing.</doc>
|
|
<source-position filename="gfileiostream.h" line="117"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22938">the entity tag for the stream.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22932">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info" c:identifier="g_file_io_stream_query_info" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22943">Queries a file io stream for the given @attributes.
|
|
This function blocks while querying the stream. For the asynchronous
|
|
version of this function, see g_file_io_stream_query_info_async().
|
|
While the stream is blocked, the stream will set the pending flag
|
|
internally, and any other operations on the stream will fail with
|
|
%G_IO_ERROR_PENDING.
|
|
|
|
Can fail if the stream was already closed (with @error being set to
|
|
%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
|
|
set to %G_IO_ERROR_PENDING), or if querying info is not supported for
|
|
the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). I
|
|
all cases of failure, %NULL will be returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
|
|
be returned.</doc>
|
|
<source-position filename="gfileiostream.h" line="101"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22968">a #GFileInfo for the @stream, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22945">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22946">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22947">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_async" c:identifier="g_file_io_stream_query_info_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22973">Asynchronously queries the @stream for a #GFileInfo. When completed,
|
|
@callback will be called with a #GAsyncResult which can be used to
|
|
finish the operation with g_file_io_stream_query_info_finish().
|
|
|
|
For the synchronous version of this function, see
|
|
g_file_io_stream_query_info().</doc>
|
|
<source-position filename="gfileiostream.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22975">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22976">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22977">the [I/O priority][gio-GIOScheduler] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22978">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22979">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22980">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_finish" c:identifier="g_file_io_stream_query_info_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22993">Finalizes the asynchronous query started
|
|
by g_file_io_stream_query_info_async().</doc>
|
|
<source-position filename="gfileiostream.h" line="113"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23002">A #GFileInfo for the finished query.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22995">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22996">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="IOStream" c:type="GIOStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="FileIOStreamPrivate" c:type="GFileIOStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="FileIOStreamClass" c:type="GFileIOStreamClass" glib:is-gtype-struct-for="FileIOStream">
|
|
<source-position filename="gfileiostream.h" line="95"/>
|
|
<field name="parent_class">
|
|
<type name="IOStreamClass" c:type="GIOStreamClass"/>
|
|
</field>
|
|
<field name="tell">
|
|
<callback name="tell">
|
|
<source-position filename="gfileiostream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_seek">
|
|
<callback name="can_seek">
|
|
<source-position filename="gfileiostream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="seek">
|
|
<callback name="seek" throws="1">
|
|
<source-position filename="gfileiostream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_truncate">
|
|
<callback name="can_truncate">
|
|
<source-position filename="gfileiostream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="truncate_fn">
|
|
<callback name="truncate_fn" throws="1">
|
|
<source-position filename="gfileiostream.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info">
|
|
<callback name="query_info" throws="1">
|
|
<source-position filename="gfileiostream.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22968">a #GFileInfo for the @stream, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22945">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22946">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22947">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_async">
|
|
<callback name="query_info_async">
|
|
<source-position filename="gfileiostream.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22975">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22976">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22977">the [I/O priority][gio-GIOScheduler] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22978">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22979">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22980">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_finish">
|
|
<callback name="query_info_finish" throws="1">
|
|
<source-position filename="gfileiostream.h" line="84"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23002">A #GFileInfo for the finished query.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22995">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22996">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_etag">
|
|
<callback name="get_etag">
|
|
<source-position filename="gfileiostream.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22938">the entity tag for the stream.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22932">a #GFileIOStream.</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfileiostream.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfileiostream.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfileiostream.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gfileiostream.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gfileiostream.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="FileIOStreamPrivate" c:type="GFileIOStreamPrivate" disguised="1">
|
|
<source-position filename="gfileiostream.h" line="48"/>
|
|
</record>
|
|
<class name="FileIcon" c:symbol-prefix="file_icon" c:type="GFileIcon" parent="GObject.Object" glib:type-name="GFileIcon" glib:get-type="g_file_icon_get_type" glib:type-struct="FileIconClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6383">#GFileIcon specifies an icon by pointing to an image file
|
|
to be used as icon.</doc>
|
|
<source-position filename="gfileicon.h" line="44"/>
|
|
<implements name="Icon"/>
|
|
<implements name="LoadableIcon"/>
|
|
<constructor name="new" c:identifier="g_file_icon_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22128">Creates a new icon for a file.</doc>
|
|
<source-position filename="gfileicon.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22134">a #GIcon for the given
|
|
@file, or %NULL on error.</doc>
|
|
<type name="FileIcon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22130">a #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_file" c:identifier="g_file_icon_get_file">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22118">Gets the #GFile associated with the given @icon.</doc>
|
|
<source-position filename="gfileicon.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22124">a #GFile, or %NULL.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22120">a #GIcon.</doc>
|
|
<type name="FileIcon" c:type="GFileIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="file" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1777">The file containing the icon.</doc>
|
|
<type name="File"/>
|
|
</property>
|
|
</class>
|
|
<record name="FileIconClass" c:type="GFileIconClass" disguised="1" glib:is-gtype-struct-for="FileIcon">
|
|
<source-position filename="gfileicon.h" line="44"/>
|
|
</record>
|
|
<record name="FileIface" c:type="GFileIface" glib:is-gtype-struct-for="File">
|
|
<doc xml:space="preserve" filename="gfile.h" line="50">An interface for writing VFS file handles.</doc>
|
|
<source-position filename="gfile.h" line="589"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gfile.h" line="52">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="dup">
|
|
<callback name="dup">
|
|
<source-position filename="gfile.h" line="165"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21402">a new #GFile that is a duplicate
|
|
of the given #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21389">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="hash">
|
|
<callback name="hash">
|
|
<source-position filename="gfile.h" line="166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22111">0 if @file is not a valid #GFile, otherwise an
|
|
integer that can be used as hash value for the #GFile.
|
|
This function is intended for easily hashing a #GFile to
|
|
add to a #GHashTable or similar data structure.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22105">#gconstpointer to a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="equal">
|
|
<callback name="equal">
|
|
<source-position filename="gfile.h" line="167"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21816">%TRUE if @file1 and @file2 are equal.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21805">the first #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="file2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21806">the second #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_native">
|
|
<callback name="is_native">
|
|
<source-position filename="gfile.h" line="169"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23023">%TRUE if @file is native</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23009">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="has_uri_scheme">
|
|
<callback name="has_uri_scheme">
|
|
<source-position filename="gfile.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22097">%TRUE if #GFile's backend supports the
|
|
given URI scheme, %FALSE if URI scheme is %NULL,
|
|
not supported, or #GFile is invalid.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22090">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22091">a string containing a URI scheme</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_uri_scheme">
|
|
<callback name="get_uri_scheme">
|
|
<source-position filename="gfile.h" line="172"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22040">a string containing the URI scheme for the given
|
|
#GFile. The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22029">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_basename">
|
|
<callback name="get_basename">
|
|
<source-position filename="gfile.h" line="173"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_path">
|
|
<callback name="get_path">
|
|
<source-position filename="gfile.h" line="174"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_uri">
|
|
<callback name="get_uri">
|
|
<source-position filename="gfile.h" line="175"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22021">a string containing the #GFile's URI.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22015">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_parse_name">
|
|
<callback name="get_parse_name">
|
|
<source-position filename="gfile.h" line="176"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21976">a string containing the #GFile's parse name.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21959">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_parent">
|
|
<callback name="get_parent">
|
|
<source-position filename="gfile.h" line="177"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21951">a #GFile structure to the
|
|
parent of the given #GFile or %NULL if there is no parent. Free
|
|
the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21943">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="prefix_matches">
|
|
<callback name="prefix_matches">
|
|
<source-position filename="gfile.h" line="178"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22083">%TRUE if the @files's parent, grandparent, etc is @prefix,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="prefix" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22066">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22065">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_relative_path">
|
|
<callback name="get_relative_path">
|
|
<source-position filename="gfile.h" line="180"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parent" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="descendant" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="resolve_relative_path">
|
|
<callback name="resolve_relative_path">
|
|
<source-position filename="gfile.h" line="182"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24637">#GFile to the resolved path.
|
|
%NULL if @relative_path is %NULL or if @file is invalid.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24630">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="relative_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24631">a given relative path string</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_child_for_display_name">
|
|
<callback name="get_child_for_display_name" throws="1">
|
|
<source-position filename="gfile.h" line="184"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21935">a #GFile to the specified child, or
|
|
%NULL if the display name couldn't be converted.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21922">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21923">string to a possible child</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="enumerate_children">
|
|
<callback name="enumerate_children" throws="1">
|
|
<source-position filename="gfile.h" line="188"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21519">A #GFileEnumerator if successful,
|
|
%NULL on error. Free the returned object with g_object_unref().</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21488">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21489">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21490">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21491">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="enumerate_children_async">
|
|
<callback name="enumerate_children_async">
|
|
<source-position filename="gfile.h" line="193"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21526">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21527">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21528">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21529">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21530">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21532">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21534">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="enumerate_children_finish">
|
|
<callback name="enumerate_children_finish" throws="1">
|
|
<source-position filename="gfile.h" line="200"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21558">a #GFileEnumerator or %NULL
|
|
if an error occurred.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileEnumerator" c:type="GFileEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21551">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21552">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info">
|
|
<callback name="query_info" throws="1">
|
|
<source-position filename="gfile.h" line="204"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24199">a #GFileInfo for the given @file, or %NULL
|
|
on error. Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24161">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24162">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24163">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24164">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_async">
|
|
<callback name="query_info_async">
|
|
<source-position filename="gfile.h" line="209"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24206">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24207">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24208">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24209">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24210">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24212">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24214">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_finish">
|
|
<callback name="query_info_finish" throws="1">
|
|
<source-position filename="gfile.h" line="216"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24237">#GFileInfo for given @file
|
|
or %NULL on error. Free the returned object with
|
|
g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24230">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24231">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_filesystem_info">
|
|
<callback name="query_filesystem_info" throws="1">
|
|
<source-position filename="gfile.h" line="220"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24114">a #GFileInfo or %NULL if there was an error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24082">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24083">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24084">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_filesystem_info_async">
|
|
<callback name="query_filesystem_info_async">
|
|
<source-position filename="gfile.h" line="224"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24121">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24122">an attribute query string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24123">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24124">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24126">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24128">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_filesystem_info_finish">
|
|
<callback name="query_filesystem_info_finish" throws="1">
|
|
<source-position filename="gfile.h" line="230"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24153">#GFileInfo for given @file
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24146">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24147">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="find_enclosing_mount">
|
|
<callback name="find_enclosing_mount" throws="1">
|
|
<source-position filename="gfile.h" line="234"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21837">a #GMount where the @file is located
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21822">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21823">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="find_enclosing_mount_async">
|
|
<callback name="find_enclosing_mount_async">
|
|
<source-position filename="gfile.h" line="237"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21845">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21846">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21847">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21849">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21851">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="find_enclosing_mount_finish">
|
|
<callback name="find_enclosing_mount_finish" throws="1">
|
|
<source-position filename="gfile.h" line="242"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21873">#GMount for given @file or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21866">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21867">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_display_name">
|
|
<callback name="set_display_name" throws="1">
|
|
<source-position filename="gfile.h" line="246"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24884">a #GFile specifying what @file was renamed to,
|
|
or %NULL if there was an error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24862">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24863">a string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24864">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_display_name_async">
|
|
<callback name="set_display_name_async">
|
|
<source-position filename="gfile.h" line="250"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24892">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24893">a string</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24894">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24895">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24897">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24899">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_display_name_finish">
|
|
<callback name="set_display_name_finish" throws="1">
|
|
<source-position filename="gfile.h" line="256"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24921">a #GFile or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24914">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24915">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_settable_attributes">
|
|
<callback name="query_settable_attributes" throws="1">
|
|
<source-position filename="gfile.h" line="260"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24261">a #GFileAttributeInfoList describing the settable attributes.
|
|
When you are done with it, release it with
|
|
g_file_attribute_info_list_unref()</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24245">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24246">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_query_settable_attributes_async" introspectable="0">
|
|
<callback name="_query_settable_attributes_async">
|
|
<source-position filename="gfile.h" line="263"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_query_settable_attributes_finish" introspectable="0">
|
|
<callback name="_query_settable_attributes_finish">
|
|
<source-position filename="gfile.h" line="264"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="query_writable_namespaces">
|
|
<callback name="query_writable_namespaces" throws="1">
|
|
<source-position filename="gfile.h" line="266"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24282">a #GFileAttributeInfoList describing the writable namespaces.
|
|
When you are done with it, release it with
|
|
g_file_attribute_info_list_unref()</doc>
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24269">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24270">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_query_writable_namespaces_async" introspectable="0">
|
|
<callback name="_query_writable_namespaces_async">
|
|
<source-position filename="gfile.h" line="269"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_query_writable_namespaces_finish" introspectable="0">
|
|
<callback name="_query_writable_namespaces_finish">
|
|
<source-position filename="gfile.h" line="270"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="set_attribute">
|
|
<callback name="set_attribute" throws="1">
|
|
<source-position filename="gfile.h" line="272"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24664">%TRUE if the attribute was set, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24645">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24646">a string containing the attribute's name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24647">The type of the attribute</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType"/>
|
|
</parameter>
|
|
<parameter name="value_p" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24648">a pointer to the value (or the pointer
|
|
itself if the type is a pointer type)</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24650">a set of #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24651">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_attributes_from_info">
|
|
<callback name="set_attributes_from_info" throws="1">
|
|
<source-position filename="gfile.h" line="279"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24856">%FALSE if there was any error, %TRUE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24836">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24837">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24838">#GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24839">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_attributes_async">
|
|
<callback name="set_attributes_async">
|
|
<source-position filename="gfile.h" line="284"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24801">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24802">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24803">a #GFileQueryInfoFlags</doc>
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24804">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24805">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24807">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24808">a #gpointer</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_attributes_finish">
|
|
<callback name="set_attributes_finish" throws="1">
|
|
<source-position filename="gfile.h" line="291"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24830">%TRUE if the attributes were set correctly, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24823">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24824">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="info" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24825">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="read_fn">
|
|
<callback name="read_fn" throws="1">
|
|
<source-position filename="gfile.h" line="296"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24306">#GFileInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24290">#GFile to read</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24291">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="read_async">
|
|
<callback name="read_async">
|
|
<source-position filename="gfile.h" line="299"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24313">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24314">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24315">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24317">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24319">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="read_finish">
|
|
<callback name="read_finish" throws="1">
|
|
<source-position filename="gfile.h" line="304"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24341">a #GFileInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24334">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24335">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="append_to">
|
|
<callback name="append_to" throws="1">
|
|
<source-position filename="gfile.h" line="308"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20801">a #GFileOutputStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20777">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20778">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20779">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="append_to_async">
|
|
<callback name="append_to_async">
|
|
<source-position filename="gfile.h" line="312"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20808">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20809">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20810">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20811">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20813">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20815">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="append_to_finish">
|
|
<callback name="append_to_finish" throws="1">
|
|
<source-position filename="gfile.h" line="318"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20837">a valid #GFileOutputStream
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20830">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20831">#GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create">
|
|
<callback name="create" throws="1">
|
|
<source-position filename="gfile.h" line="322"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21205">a #GFileOutputStream for the newly created
|
|
file, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21179">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21180">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21181">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_async">
|
|
<callback name="create_async">
|
|
<source-position filename="gfile.h" line="326"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21213">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21214">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21215">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21216">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21218">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21220">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_finish">
|
|
<callback name="create_finish" throws="1">
|
|
<source-position filename="gfile.h" line="332"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21243">a #GFileOutputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21236">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21237">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="replace">
|
|
<callback name="replace" throws="1">
|
|
<source-position filename="gfile.h" line="336"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24399">a #GFileOutputStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24348">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24349">an optional [entity tag][gfile-etag]
|
|
for the current #GFile, or #NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24351">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24352">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24353">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="replace_async">
|
|
<callback name="replace_async">
|
|
<source-position filename="gfile.h" line="342"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24406">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24407">an [entity tag][gfile-etag] for the current #GFile,
|
|
or %NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24409">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24410">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24411">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24412">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24414">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24416">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="replace_finish">
|
|
<callback name="replace_finish" throws="1">
|
|
<source-position filename="gfile.h" line="350"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24551">a #GFileOutputStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24544">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24545">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="delete_file">
|
|
<callback name="delete_file" throws="1">
|
|
<source-position filename="gfile.h" line="354"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21341">%TRUE if the file was deleted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21329">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21330">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="delete_file_async">
|
|
<callback name="delete_file_async">
|
|
<source-position filename="gfile.h" line="357"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21347">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21348">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21349">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21351">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21353">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="delete_file_finish">
|
|
<callback name="delete_file_finish" throws="1">
|
|
<source-position filename="gfile.h" line="362"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21371">%TRUE if the file was deleted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21365">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21366">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="trash">
|
|
<callback name="trash" throws="1">
|
|
<source-position filename="gfile.h" line="366"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25041">%TRUE on successful trash, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25027">#GFile to send to trash</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25028">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="trash_async">
|
|
<callback name="trash_async">
|
|
<source-position filename="gfile.h" line="369"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25047">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25048">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25049">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25051">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25053">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="trash_finish">
|
|
<callback name="trash_finish" throws="1">
|
|
<source-position filename="gfile.h" line="374"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25070">%TRUE on successful trash, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25063">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25064">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="make_directory">
|
|
<callback name="make_directory" throws="1">
|
|
<source-position filename="gfile.h" line="378"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23237">%TRUE on successful creation, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23217">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23218">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="make_directory_async">
|
|
<callback name="make_directory_async">
|
|
<source-position filename="gfile.h" line="381"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23243">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23244">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23245">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23247">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23249">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="make_directory_finish">
|
|
<callback name="make_directory_finish" throws="1">
|
|
<source-position filename="gfile.h" line="386"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23266">%TRUE on successful directory creation, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23259">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23260">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="make_symbolic_link">
|
|
<callback name="make_symbolic_link" throws="1">
|
|
<source-position filename="gfile.h" line="390"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23314">%TRUE on the creation of a new symlink, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23300">a #GFile with the name of the symlink to create</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="symlink_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23301">a string with the path for the target
|
|
of the new symlink</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23303">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_make_symbolic_link_async" introspectable="0">
|
|
<callback name="_make_symbolic_link_async">
|
|
<source-position filename="gfile.h" line="394"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_make_symbolic_link_finish" introspectable="0">
|
|
<callback name="_make_symbolic_link_finish">
|
|
<source-position filename="gfile.h" line="395"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="copy">
|
|
<callback name="copy" throws="1">
|
|
<source-position filename="gfile.h" line="397"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21111">%TRUE on success, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21060">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21061">destination #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21062">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21063">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21065">function to callback with
|
|
progress information, or %NULL if progress information is not needed</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21067">user data to pass to @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="copy_async">
|
|
<callback name="copy_async">
|
|
<source-position filename="gfile.h" line="404"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21117">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21118">destination #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21119">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21120">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21121">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21123">function to callback with progress
|
|
information, or %NULL if progress information is not needed</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21125">user data to pass to @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="8">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21126">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21127">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="copy_finish">
|
|
<callback name="copy_finish" throws="1">
|
|
<source-position filename="gfile.h" line="413"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21173">a %TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21167">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21168">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="move">
|
|
<callback name="move" throws="1">
|
|
<source-position filename="gfile.h" line="417"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23652">%TRUE on successful move, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23603">#GFile pointing to the source location</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="destination" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23604">#GFile pointing to the destination location</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23605">set of #GFileCopyFlags</doc>
|
|
<type name="FileCopyFlags" c:type="GFileCopyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23606">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" scope="call" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23608">#GFileProgressCallback
|
|
function for updates</doc>
|
|
<type name="FileProgressCallback" c:type="GFileProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23610">gpointer to user data for
|
|
the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_move_async" introspectable="0">
|
|
<callback name="_move_async">
|
|
<source-position filename="gfile.h" line="424"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_move_finish" introspectable="0">
|
|
<callback name="_move_finish">
|
|
<source-position filename="gfile.h" line="425"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_mountable">
|
|
<callback name="mount_mountable">
|
|
<source-position filename="gfile.h" line="427"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23561">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23562">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23563">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23565">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23567">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23569">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_mountable_finish">
|
|
<callback name="mount_mountable_finish" throws="1">
|
|
<source-position filename="gfile.h" line="433"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23596">a #GFile or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23587">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23588">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmount_mountable">
|
|
<callback name="unmount_mountable">
|
|
<source-position filename="gfile.h" line="437"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25077">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25078">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25079">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25081">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25083">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmount_mountable_finish">
|
|
<callback name="unmount_mountable_finish" throws="1">
|
|
<source-position filename="gfile.h" line="442"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25110">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25101">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25102">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_mountable">
|
|
<callback name="eject_mountable">
|
|
<source-position filename="gfile.h" line="446"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21409">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21410">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21411">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21413">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21415">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_mountable_finish">
|
|
<callback name="eject_mountable_finish" throws="1">
|
|
<source-position filename="gfile.h" line="451"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21439">%TRUE if the @file was ejected successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21432">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21433">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_enclosing_volume">
|
|
<callback name="mount_enclosing_volume">
|
|
<source-position filename="gfile.h" line="455"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="location" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23522">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23523">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23524">a #GMountOperation
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23526">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23528">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23530">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_enclosing_volume_finish">
|
|
<callback name="mount_enclosing_volume_finish" throws="1">
|
|
<source-position filename="gfile.h" line="461"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23553">%TRUE if successful. If an error has occurred,
|
|
this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="location" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23547">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23548">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="monitor_dir">
|
|
<callback name="monitor_dir" throws="1">
|
|
<source-position filename="gfile.h" line="465"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23447">a #GFileMonitor for the given @file,
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23428">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23429">a set of #GFileMonitorFlags</doc>
|
|
<type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23430">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="monitor_file">
|
|
<callback name="monitor_file" throws="1">
|
|
<source-position filename="gfile.h" line="469"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23493">a #GFileMonitor for the given @file,
|
|
or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23472">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23473">a set of #GFileMonitorFlags</doc>
|
|
<type name="FileMonitorFlags" c:type="GFileMonitorFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23474">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="open_readwrite">
|
|
<callback name="open_readwrite" throws="1">
|
|
<source-position filename="gfile.h" line="474"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23793">#GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23772">#GFile to open</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23773">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="open_readwrite_async">
|
|
<callback name="open_readwrite_async">
|
|
<source-position filename="gfile.h" line="477"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23801">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23802">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23803">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23805">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23807">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="open_readwrite_finish">
|
|
<callback name="open_readwrite_finish" throws="1">
|
|
<source-position filename="gfile.h" line="482"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23831">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23824">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23825">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_readwrite">
|
|
<callback name="create_readwrite" throws="1">
|
|
<source-position filename="gfile.h" line="485"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21280">a #GFileIOStream for the newly created
|
|
file, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21250">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21251">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21252">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_readwrite_async">
|
|
<callback name="create_readwrite_async">
|
|
<source-position filename="gfile.h" line="489"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21289">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21290">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21291">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21292">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21294">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21296">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_readwrite_finish">
|
|
<callback name="create_readwrite_finish" throws="1">
|
|
<source-position filename="gfile.h" line="495"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21321">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21314">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21315">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="replace_readwrite">
|
|
<callback name="replace_readwrite" throws="1">
|
|
<source-position filename="gfile.h" line="498"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24578">a #GFileIOStream or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24558">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24559">an optional [entity tag][gfile-etag]
|
|
for the current #GFile, or #NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24561">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24562">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24563">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="replace_readwrite_async">
|
|
<callback name="replace_readwrite_async">
|
|
<source-position filename="gfile.h" line="504"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24586">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="etag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24587">an [entity tag][gfile-etag] for the current #GFile,
|
|
or %NULL to ignore</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="make_backup" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24589">%TRUE if a backup should be created</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24590">a set of #GFileCreateFlags</doc>
|
|
<type name="FileCreateFlags" c:type="GFileCreateFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24591">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24592">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24594">a #GAsyncReadyCallback to call
|
|
when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24596">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="replace_readwrite_finish">
|
|
<callback name="replace_readwrite_finish" throws="1">
|
|
<source-position filename="gfile.h" line="512"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24622">a #GFileIOStream, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24615">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24616">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start_mountable">
|
|
<callback name="start_mountable">
|
|
<source-position filename="gfile.h" line="516"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24928">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24929">flags affecting the operation</doc>
|
|
<type name="DriveStartFlags" c:type="GDriveStartFlags"/>
|
|
</parameter>
|
|
<parameter name="start_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24930">a #GMountOperation, or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24931">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24932">a #GAsyncReadyCallback to call when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24933">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="start_mountable_finish">
|
|
<callback name="start_mountable_finish" throws="1">
|
|
<source-position filename="gfile.h" line="522"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24962">%TRUE if the operation finished successfully. %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24953">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24954">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop_mountable">
|
|
<callback name="stop_mountable">
|
|
<source-position filename="gfile.h" line="526"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24970">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24971">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24972">a #GMountOperation,
|
|
or %NULL to avoid user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24974">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24976">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24978">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="stop_mountable_finish">
|
|
<callback name="stop_mountable_finish" throws="1">
|
|
<source-position filename="gfile.h" line="532"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25005">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24996">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="24997">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="supports_thread_contexts">
|
|
<doc xml:space="preserve" filename="gfile.h" line="146">a boolean that indicates whether the #GFile implementation supports thread-default contexts. Since 2.22.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</field>
|
|
<field name="unmount_mountable_with_operation">
|
|
<callback name="unmount_mountable_with_operation">
|
|
<source-position filename="gfile.h" line="538"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25119">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25120">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25121">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25123">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25125">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25127">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmount_mountable_with_operation_finish">
|
|
<callback name="unmount_mountable_with_operation_finish" throws="1">
|
|
<source-position filename="gfile.h" line="544"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25155">%TRUE if the operation finished successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25145">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25146">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_mountable_with_operation">
|
|
<callback name="eject_mountable_with_operation">
|
|
<source-position filename="gfile.h" line="548"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21448">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21449">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21450">a #GMountOperation,
|
|
or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21452">optional #GCancellable object,
|
|
%NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21454">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21456">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_mountable_with_operation_finish">
|
|
<callback name="eject_mountable_with_operation_finish" throws="1">
|
|
<source-position filename="gfile.h" line="554"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21480">%TRUE if the @file was ejected successfully.
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21473">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="21474">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="poll_mountable">
|
|
<callback name="poll_mountable">
|
|
<source-position filename="gfile.h" line="558"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23942">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23943">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23944">a #GAsyncReadyCallback to call
|
|
when the request is satisfied, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23946">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="poll_mountable_finish">
|
|
<callback name="poll_mountable_finish" throws="1">
|
|
<source-position filename="gfile.h" line="562"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23973">%TRUE if the operation finished successfully. %FALSE
|
|
otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23964">input #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23965">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="measure_disk_usage" introspectable="0">
|
|
<callback name="measure_disk_usage" introspectable="0" throws="1">
|
|
<source-position filename="gfile.h" line="566"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23349">%TRUE if successful, with the out parameters set.
|
|
%FALSE otherwise, with @error set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23320">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23321">#GFileMeasureFlags</doc>
|
|
<type name="FileMeasureFlags" c:type="GFileMeasureFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23322">optional #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23323">a #GFileMeasureProgressCallback</doc>
|
|
<type name="FileMeasureProgressCallback" c:type="GFileMeasureProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23324">user_data for @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="disk_usage" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23325">the number of bytes of disk space used</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_dirs" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23326">the number of directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_files" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23327">the number of non-directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="measure_disk_usage_async" introspectable="0">
|
|
<callback name="measure_disk_usage_async" introspectable="0">
|
|
<source-position filename="gfile.h" line="575"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23357">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23358">#GFileMeasureFlags</doc>
|
|
<type name="FileMeasureFlags" c:type="GFileMeasureFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23359">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23360">optional #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="progress_callback" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23361">a #GFileMeasureProgressCallback</doc>
|
|
<type name="FileMeasureProgressCallback" c:type="GFileMeasureProgressCallback"/>
|
|
</parameter>
|
|
<parameter name="progress_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23362">user_data for @progress_callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23363">a #GAsyncReadyCallback to call when complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23364">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="measure_disk_usage_finish">
|
|
<callback name="measure_disk_usage_finish" throws="1">
|
|
<source-position filename="gfile.h" line="583"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23388">%TRUE if successful, with the out parameters set.
|
|
%FALSE otherwise, with @error set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23377">a #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23378">the #GAsyncResult passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="disk_usage" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23379">the number of bytes of disk space used</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_dirs" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23380">the number of directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
<parameter name="num_files" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23381">the number of non-directories encountered</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="FileInfo" c:symbol-prefix="file_info" c:type="GFileInfo" parent="GObject.Object" glib:type-name="GFileInfo" glib:get-type="g_file_info_get_type" glib:type-struct="FileInfoClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6394">Functionality for manipulating basic metadata for files. #GFileInfo
|
|
implements methods for getting information that all files should
|
|
contain, and allows for manipulation of extended attributes.
|
|
|
|
See [GFileAttribute][gio-GFileAttribute] for more information on how
|
|
GIO handles file attributes.
|
|
|
|
To obtain a #GFileInfo for a #GFile, use g_file_query_info() (or its
|
|
async variant). To obtain a #GFileInfo for a file input or output
|
|
stream, use g_file_input_stream_query_info() or
|
|
g_file_output_stream_query_info() (or their async variants).
|
|
|
|
To change the actual attributes of a file, you should then set the
|
|
attribute in the #GFileInfo and call g_file_set_attributes_from_info()
|
|
or g_file_set_attributes_async() on a GFile.
|
|
|
|
However, not all attributes can be changed in the file. For instance,
|
|
the actual size of a file cannot be changed via g_file_info_set_size().
|
|
You may call g_file_query_settable_attributes() and
|
|
g_file_query_writable_namespaces() to discover the settable attributes
|
|
of a particular file at runtime.
|
|
|
|
#GFileAttributeMatcher allows for searching through a #GFileInfo for
|
|
attributes.</doc>
|
|
<source-position filename="gfileinfo.h" line="44"/>
|
|
<constructor name="new" c:identifier="g_file_info_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22561">Creates a new file info structure.</doc>
|
|
<source-position filename="gfileinfo.h" line="914"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22566">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="clear_status" c:identifier="g_file_info_clear_status">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22139">Clears the status information from @info.</doc>
|
|
<source-position filename="gfileinfo.h" line="1022"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22141">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy_into" c:identifier="g_file_info_copy_into">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22147">First clears all of the [GFileAttribute][gio-GFileAttribute] of @dest_info,
|
|
and then copies all of the file attributes from @src_info to @dest_info.</doc>
|
|
<source-position filename="gfileinfo.h" line="918"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="src_info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22149">source to copy attributes from.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="dest_info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22150">destination to copy attributes to.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="dup" c:identifier="g_file_info_dup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22157">Duplicates a file info structure.</doc>
|
|
<source-position filename="gfileinfo.h" line="916"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22163">a duplicate #GFileInfo of @other.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="other" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22159">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_as_string" c:identifier="g_file_info_get_attribute_as_string">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22167">Gets the value of a attribute, formated as a string.
|
|
This escapes things as needed to make the string valid
|
|
UTF-8.</doc>
|
|
<source-position filename="gfileinfo.h" line="949"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22176">a UTF-8 string associated with the given @attribute, or
|
|
%NULL if the attribute wasn’t set.
|
|
When you're done with the string it must be freed with g_free().</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22169">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22170">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_boolean" c:identifier="g_file_info_get_attribute_boolean">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22182">Gets the value of a boolean attribute. If the attribute does not
|
|
contain a boolean value, %FALSE will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="958"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22190">the boolean value contained within the attribute.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22184">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22185">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_byte_string" c:identifier="g_file_info_get_attribute_byte_string">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22194">Gets the value of a byte string attribute. If the attribute does
|
|
not contain a byte string, %NULL will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="955"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22202">the contents of the @attribute value as a byte string, or
|
|
%NULL otherwise.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22196">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22197">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_data" c:identifier="g_file_info_get_attribute_data">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22207">Gets the attribute type, value and status for an attribute key.</doc>
|
|
<source-position filename="gfileinfo.h" line="930"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22218">%TRUE if @info has an attribute named @attribute,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22209">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22210">a file attribute key</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22211">return location for the attribute type, or %NULL</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType*"/>
|
|
</parameter>
|
|
<parameter name="value_pp" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22212">return location for the
|
|
attribute value, or %NULL; the attribute value will not be %NULL</doc>
|
|
<type name="gpointer" c:type="gpointer*"/>
|
|
</parameter>
|
|
<parameter name="status" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22214">return location for the attribute status, or %NULL</doc>
|
|
<type name="FileAttributeStatus" c:type="GFileAttributeStatus*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_int32" c:identifier="g_file_info_get_attribute_int32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22223">Gets a signed 32-bit integer contained within the attribute. If the
|
|
attribute does not contain a signed 32-bit integer, or is invalid,
|
|
0 will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="964"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22232">a signed 32-bit integer from the attribute.</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22225">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22226">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_int64" c:identifier="g_file_info_get_attribute_int64">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22236">Gets a signed 64-bit integer contained within the attribute. If the
|
|
attribute does not contain an signed 64-bit integer, or is invalid,
|
|
0 will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="970"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22245">a signed 64-bit integer from the attribute.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22238">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22239">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_object" c:identifier="g_file_info_get_attribute_object">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22249">Gets the value of a #GObject attribute. If the attribute does
|
|
not contain a #GObject, %NULL will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="973"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22257">a #GObject associated with the given @attribute, or
|
|
%NULL otherwise.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22251">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22252">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_status" c:identifier="g_file_info_get_attribute_status">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22262">Gets the attribute status for an attribute key.</doc>
|
|
<source-position filename="gfileinfo.h" line="942"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22269">a #GFileAttributeStatus for the given @attribute, or
|
|
%G_FILE_ATTRIBUTE_STATUS_UNSET if the key is invalid.</doc>
|
|
<type name="FileAttributeStatus" c:type="GFileAttributeStatus"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22264">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22265">a file attribute key</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_string" c:identifier="g_file_info_get_attribute_string">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22274">Gets the value of a string attribute. If the attribute does
|
|
not contain a string, %NULL will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="952"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22282">the contents of the @attribute value as a UTF-8 string, or
|
|
%NULL otherwise.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22276">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22277">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_stringv" c:identifier="g_file_info_get_attribute_stringv" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22287">Gets the value of a stringv attribute. If the attribute does
|
|
not contain a stringv, %NULL will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="976"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22295">the contents of the @attribute value as a stringv, or
|
|
%NULL otherwise. Do not free. These returned strings are UTF-8.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22289">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22290">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_type" c:identifier="g_file_info_get_attribute_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22301">Gets the attribute type for an attribute key.</doc>
|
|
<source-position filename="gfileinfo.h" line="936"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22308">a #GFileAttributeType for the given @attribute, or
|
|
%G_FILE_ATTRIBUTE_TYPE_INVALID if the key is not set.</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22303">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22304">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_uint32" c:identifier="g_file_info_get_attribute_uint32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22313">Gets an unsigned 32-bit integer contained within the attribute. If the
|
|
attribute does not contain an unsigned 32-bit integer, or is invalid,
|
|
0 will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="961"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22322">an unsigned 32-bit integer from the attribute.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22315">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22316">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_uint64" c:identifier="g_file_info_get_attribute_uint64">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22326">Gets a unsigned 64-bit integer contained within the attribute. If the
|
|
attribute does not contain an unsigned 64-bit integer, or is invalid,
|
|
0 will be returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="967"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22335">a unsigned 64-bit integer from the attribute.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22328">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22329">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_content_type" c:identifier="g_file_info_get_content_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22339">Gets the file's content type.</doc>
|
|
<source-position filename="gfileinfo.h" line="1046"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22345">a string containing the file's content type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22341">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_deletion_date" c:identifier="g_file_info_get_deletion_date" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22349">Returns the #GDateTime representing the deletion date of the file, as
|
|
available in G_FILE_ATTRIBUTE_TRASH_DELETION_DATE. If the
|
|
G_FILE_ATTRIBUTE_TRASH_DELETION_DATE attribute is unset, %NULL is returned.</doc>
|
|
<source-position filename="gfileinfo.h" line="1026"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22357">a #GDateTime, or %NULL.</doc>
|
|
<type name="GLib.DateTime" c:type="GDateTime*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22351">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_display_name" c:identifier="g_file_info_get_display_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22362">Gets a display name for a file.</doc>
|
|
<source-position filename="gfileinfo.h" line="1038"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22368">a string containing the display name.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22364">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_edit_name" c:identifier="g_file_info_get_edit_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22372">Gets the edit name for a file.</doc>
|
|
<source-position filename="gfileinfo.h" line="1040"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22378">a string containing the edit name.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22374">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_etag" c:identifier="g_file_info_get_etag">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22382">Gets the [entity tag][gfile-etag] for a given
|
|
#GFileInfo. See %G_FILE_ATTRIBUTE_ETAG_VALUE.</doc>
|
|
<source-position filename="gfileinfo.h" line="1059"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22389">a string containing the value of the "etag:value" attribute.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22384">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_file_type" c:identifier="g_file_info_get_file_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22393">Gets a file's type (whether it is a regular file, symlink, etc).
|
|
This is different from the file's content type, see g_file_info_get_content_type().</doc>
|
|
<source-position filename="gfileinfo.h" line="1028"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22400">a #GFileType for the given file.</doc>
|
|
<type name="FileType" c:type="GFileType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22395">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_icon" c:identifier="g_file_info_get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22404">Gets the icon for a file.</doc>
|
|
<source-position filename="gfileinfo.h" line="1042"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22410">#GIcon for the given @info.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22406">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_backup" c:identifier="g_file_info_get_is_backup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22414">Checks if a file is a backup file.</doc>
|
|
<source-position filename="gfileinfo.h" line="1032"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22420">%TRUE if file is a backup file, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22416">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_hidden" c:identifier="g_file_info_get_is_hidden">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22424">Checks if a file is hidden.</doc>
|
|
<source-position filename="gfileinfo.h" line="1030"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22430">%TRUE if the file is a hidden file, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22426">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_symlink" c:identifier="g_file_info_get_is_symlink">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22434">Checks if a file is a symlink.</doc>
|
|
<source-position filename="gfileinfo.h" line="1034"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22440">%TRUE if the given @info is a symlink.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22436">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_modification_date_time" c:identifier="g_file_info_get_modification_date_time" version="2.62">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22444">Gets the modification time of the current @info and returns it as a
|
|
#GDateTime.</doc>
|
|
<source-position filename="gfileinfo.h" line="1055"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22451">modification time, or %NULL if unknown</doc>
|
|
<type name="GLib.DateTime" c:type="GDateTime*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22446">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_modification_time" c:identifier="g_file_info_get_modification_time" deprecated="1" deprecated-version="2.62">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22456">Gets the modification time of the current @info and sets it
|
|
in @result.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_info_get_modification_date_time() instead, as
|
|
#GTimeVal is deprecated due to the year 2038 problem.</doc-deprecated>
|
|
<source-position filename="gfileinfo.h" line="1051"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22458">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22459">a #GTimeVal.</doc>
|
|
<type name="GLib.TimeVal" c:type="GTimeVal*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_file_info_get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22469">Gets the name for a file.</doc>
|
|
<source-position filename="gfileinfo.h" line="1036"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22475">a string containing the file name.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22471">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_size" c:identifier="g_file_info_get_size">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22479">Gets the file's size.</doc>
|
|
<source-position filename="gfileinfo.h" line="1048"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22485">a #goffset containing the file's size.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22481">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sort_order" c:identifier="g_file_info_get_sort_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22489">Gets the value of the sort_order attribute from the #GFileInfo.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.</doc>
|
|
<source-position filename="gfileinfo.h" line="1061"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22496">a #gint32 containing the value of the "standard::sort_order" attribute.</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22491">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_symbolic_icon" c:identifier="g_file_info_get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22500">Gets the symbolic icon for a file.</doc>
|
|
<source-position filename="gfileinfo.h" line="1044"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22506">#GIcon for the given @info.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22502">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_symlink_target" c:identifier="g_file_info_get_symlink_target">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22511">Gets the symlink target for a given #GFileInfo.</doc>
|
|
<source-position filename="gfileinfo.h" line="1057"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22517">a string containing the symlink target.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22513">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_attribute" c:identifier="g_file_info_has_attribute">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22521">Checks if a file info structure has an attribute named @attribute.</doc>
|
|
<source-position filename="gfileinfo.h" line="921"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22528">%TRUE if @Ginfo has an attribute named @attribute,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22523">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22524">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_namespace" c:identifier="g_file_info_has_namespace" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22533">Checks if a file info structure has an attribute in the
|
|
specified @name_space.</doc>
|
|
<source-position filename="gfileinfo.h" line="924"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22541">%TRUE if @Ginfo has an attribute in @name_space,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22535">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="name_space" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22536">a file attribute namespace.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="list_attributes" c:identifier="g_file_info_list_attributes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22547">Lists the file info structure's attributes.</doc>
|
|
<source-position filename="gfileinfo.h" line="927"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22555">a
|
|
null-terminated array of strings of all of the possible attribute
|
|
types for the given @name_space, or %NULL on error.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22549">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="name_space" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22550">a file attribute key's namespace, or %NULL to list
|
|
all attributes.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_attribute" c:identifier="g_file_info_remove_attribute">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22570">Removes all cases of @attribute from @info if it exists.</doc>
|
|
<source-position filename="gfileinfo.h" line="939"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22572">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22573">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute" c:identifier="g_file_info_set_attribute">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22579">Sets the @attribute to contain the given value, if possible. To unset the
|
|
attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type.</doc>
|
|
<source-position filename="gfileinfo.h" line="980"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22581">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22582">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22583">a #GFileAttributeType</doc>
|
|
<type name="FileAttributeType" c:type="GFileAttributeType"/>
|
|
</parameter>
|
|
<parameter name="value_p" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22584">pointer to the value</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_boolean" c:identifier="g_file_info_set_attribute_boolean">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22591">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="993"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22593">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22594">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22595">a boolean value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_byte_string" c:identifier="g_file_info_set_attribute_byte_string">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22602">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="989"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22604">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22605">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22606">a byte string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_int32" c:identifier="g_file_info_set_attribute_int32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22613">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="1001"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22615">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22616">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22617">a signed 32-bit integer</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_int64" c:identifier="g_file_info_set_attribute_int64">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22624">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="1009"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22626">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22627">attribute name to set.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22628">int64 value to set attribute to.</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_mask" c:identifier="g_file_info_set_attribute_mask">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22635">Sets @mask on @info to match specific attribute types.</doc>
|
|
<source-position filename="gfileinfo.h" line="1064"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22637">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22638">a #GFileAttributeMatcher.</doc>
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_object" c:identifier="g_file_info_set_attribute_object">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22644">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="1013"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22646">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22647">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22648">a #GObject.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_status" c:identifier="g_file_info_set_attribute_status" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22655">Sets the attribute status for an attribute key. This is only
|
|
needed by external code that implement g_file_set_attributes_from_info()
|
|
or similar functions.
|
|
|
|
The attribute must exist in @info for this to work. Otherwise %FALSE
|
|
is returned and @info is unchanged.</doc>
|
|
<source-position filename="gfileinfo.h" line="945"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22668">%TRUE if the status was changed, %FALSE if the key was not set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22657">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22658">a file attribute key</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="status" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22659">a #GFileAttributeStatus</doc>
|
|
<type name="FileAttributeStatus" c:type="GFileAttributeStatus"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_string" c:identifier="g_file_info_set_attribute_string">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22673">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="985"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22675">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22676">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22677">a UTF-8 string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_stringv" c:identifier="g_file_info_set_attribute_stringv">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22684">Sets the @attribute to contain the given @attr_value,
|
|
if possible.
|
|
|
|
Sinze: 2.22</doc>
|
|
<source-position filename="gfileinfo.h" line="1017"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22686">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22687">a file attribute key</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22688">a %NULL
|
|
terminated array of UTF-8 strings.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_uint32" c:identifier="g_file_info_set_attribute_uint32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22698">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="997"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22700">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22701">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22702">an unsigned 32-bit integer.</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_uint64" c:identifier="g_file_info_set_attribute_uint64">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22709">Sets the @attribute to contain the given @attr_value,
|
|
if possible.</doc>
|
|
<source-position filename="gfileinfo.h" line="1005"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22711">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22712">a file attribute key.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="attr_value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22713">an unsigned 64-bit integer.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_content_type" c:identifier="g_file_info_set_content_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22720">Sets the content type attribute for a given #GFileInfo.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE.</doc>
|
|
<source-position filename="gfileinfo.h" line="1095"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22722">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22723">a content type. See [GContentType][gio-GContentType]</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_display_name" c:identifier="g_file_info_set_display_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22730">Sets the display name for the current #GFileInfo.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME.</doc>
|
|
<source-position filename="gfileinfo.h" line="1083"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22732">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="display_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22733">a string containing a display name.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_edit_name" c:identifier="g_file_info_set_edit_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22740">Sets the edit name for the current file.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME.</doc>
|
|
<source-position filename="gfileinfo.h" line="1086"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22742">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="edit_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22743">a string containing an edit name.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_file_type" c:identifier="g_file_info_set_file_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22750">Sets the file type in a #GFileInfo to @type.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_TYPE.</doc>
|
|
<source-position filename="gfileinfo.h" line="1071"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22752">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22753">a #GFileType.</doc>
|
|
<type name="FileType" c:type="GFileType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_icon" c:identifier="g_file_info_set_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22760">Sets the icon for a given #GFileInfo.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_ICON.</doc>
|
|
<source-position filename="gfileinfo.h" line="1089"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22762">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22763">a #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_is_hidden" c:identifier="g_file_info_set_is_hidden">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22770">Sets the "is_hidden" attribute in a #GFileInfo according to @is_hidden.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN.</doc>
|
|
<source-position filename="gfileinfo.h" line="1074"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22772">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="is_hidden" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22773">a #gboolean.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_is_symlink" c:identifier="g_file_info_set_is_symlink">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22780">Sets the "is_symlink" attribute in a #GFileInfo according to @is_symlink.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK.</doc>
|
|
<source-position filename="gfileinfo.h" line="1077"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22782">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="is_symlink" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22783">a #gboolean.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_modification_date_time" c:identifier="g_file_info_set_modification_date_time" version="2.62">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22790">Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
|
|
info to the given date/time value.</doc>
|
|
<source-position filename="gfileinfo.h" line="1106"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22792">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="mtime" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22793">a #GDateTime.</doc>
|
|
<type name="GLib.DateTime" c:type="GDateTime*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_modification_time" c:identifier="g_file_info_set_modification_time" deprecated="1" deprecated-version="2.62">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22802">Sets the %G_FILE_ATTRIBUTE_TIME_MODIFIED attribute in the file
|
|
info to the given time value.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_file_info_set_modification_date_time() instead, as
|
|
#GTimeVal is deprecated due to the year 2038 problem.</doc-deprecated>
|
|
<source-position filename="gfileinfo.h" line="1102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22804">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="mtime" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22805">a #GTimeVal.</doc>
|
|
<type name="GLib.TimeVal" c:type="GTimeVal*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_name" c:identifier="g_file_info_set_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22815">Sets the name attribute for the current #GFileInfo.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_NAME.</doc>
|
|
<source-position filename="gfileinfo.h" line="1080"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22817">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22818">a string containing a name.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_size" c:identifier="g_file_info_set_size">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22825">Sets the %G_FILE_ATTRIBUTE_STANDARD_SIZE attribute in the file info
|
|
to the given size.</doc>
|
|
<source-position filename="gfileinfo.h" line="1098"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22827">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22828">a #goffset containing the file's size.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_sort_order" c:identifier="g_file_info_set_sort_order">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22835">Sets the sort order attribute in the file info structure. See
|
|
%G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER.</doc>
|
|
<source-position filename="gfileinfo.h" line="1112"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22837">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="sort_order" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22838">a sort order integer.</doc>
|
|
<type name="gint32" c:type="gint32"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_symbolic_icon" c:identifier="g_file_info_set_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22845">Sets the symbolic icon for a given #GFileInfo.
|
|
See %G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON.</doc>
|
|
<source-position filename="gfileinfo.h" line="1092"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22847">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22848">a #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_symlink_target" c:identifier="g_file_info_set_symlink_target">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22857">Sets the %G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET attribute in the file info
|
|
to the given symlink target.</doc>
|
|
<source-position filename="gfileinfo.h" line="1109"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22859">a #GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
<parameter name="symlink_target" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22860">a static string containing a path to a symlink target.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unset_attribute_mask" c:identifier="g_file_info_unset_attribute_mask">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22867">Unsets a mask set by g_file_info_set_attribute_mask(), if one
|
|
is set.</doc>
|
|
<source-position filename="gfileinfo.h" line="1067"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="info" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22869">#GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<record name="FileInfoClass" c:type="GFileInfoClass" disguised="1" glib:is-gtype-struct-for="FileInfo">
|
|
<source-position filename="gfileinfo.h" line="44"/>
|
|
</record>
|
|
<class name="FileInputStream" c:symbol-prefix="file_input_stream" c:type="GFileInputStream" parent="InputStream" glib:type-name="GFileInputStream" glib:get-type="g_file_input_stream_get_type" glib:type-struct="FileInputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6427">GFileInputStream provides input streams that take their
|
|
content from a file.
|
|
|
|
GFileInputStream implements #GSeekable, which allows the input
|
|
stream to jump to arbitrary positions in the file, provided the
|
|
filesystem of the file allows it. To find the position of a file
|
|
input stream, use g_seekable_tell(). To find out if a file input
|
|
stream supports seeking, use g_seekable_can_seek().
|
|
To position a file input stream, use g_seekable_seek().</doc>
|
|
<source-position filename="gfileinputstream.h" line="90"/>
|
|
<implements name="Seekable"/>
|
|
<virtual-method name="can_seek">
|
|
<source-position filename="gfileinputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info" invoker="query_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22876">Queries a file input stream the given @attributes. This function blocks
|
|
while querying the stream. For the asynchronous (non-blocking) version
|
|
of this function, see g_file_input_stream_query_info_async(). While the
|
|
stream is blocked, the stream will set the pending flag internally, and
|
|
any other operations on the stream will fail with %G_IO_ERROR_PENDING.</doc>
|
|
<source-position filename="gfileinputstream.h" line="69"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22890">a #GFileInfo, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22878">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22879">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22880">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_async" invoker="query_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22894">Queries the stream information asynchronously.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_file_input_stream_query_info_finish()
|
|
to get the result of the operation.
|
|
|
|
For the synchronous version of this function,
|
|
see g_file_input_stream_query_info().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set</doc>
|
|
<source-position filename="gfileinputstream.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22896">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22897">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22898">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22899">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22900">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22901">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_finish" invoker="query_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22917">Finishes an asynchronous info query operation.</doc>
|
|
<source-position filename="gfileinputstream.h" line="79"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22926">#GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22919">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22920">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="seek" throws="1">
|
|
<source-position filename="gfileinputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="tell">
|
|
<source-position filename="gfileinputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="query_info" c:identifier="g_file_input_stream_query_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22876">Queries a file input stream the given @attributes. This function blocks
|
|
while querying the stream. For the asynchronous (non-blocking) version
|
|
of this function, see g_file_input_stream_query_info_async(). While the
|
|
stream is blocked, the stream will set the pending flag internally, and
|
|
any other operations on the stream will fail with %G_IO_ERROR_PENDING.</doc>
|
|
<source-position filename="gfileinputstream.h" line="96"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22890">a #GFileInfo, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22878">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22879">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22880">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_async" c:identifier="g_file_input_stream_query_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22894">Queries the stream information asynchronously.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_file_input_stream_query_info_finish()
|
|
to get the result of the operation.
|
|
|
|
For the synchronous version of this function,
|
|
see g_file_input_stream_query_info().
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set</doc>
|
|
<source-position filename="gfileinputstream.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22896">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22897">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22898">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22899">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22900">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22901">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_finish" c:identifier="g_file_input_stream_query_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22917">Finishes an asynchronous info query operation.</doc>
|
|
<source-position filename="gfileinputstream.h" line="108"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22926">#GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22919">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22920">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="InputStream" c:type="GInputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="FileInputStreamPrivate" c:type="GFileInputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="FileInputStreamClass" c:type="GFileInputStreamClass" glib:is-gtype-struct-for="FileInputStream">
|
|
<source-position filename="gfileinputstream.h" line="90"/>
|
|
<field name="parent_class">
|
|
<type name="InputStreamClass" c:type="GInputStreamClass"/>
|
|
</field>
|
|
<field name="tell">
|
|
<callback name="tell">
|
|
<source-position filename="gfileinputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_seek">
|
|
<callback name="can_seek">
|
|
<source-position filename="gfileinputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="seek">
|
|
<callback name="seek" throws="1">
|
|
<source-position filename="gfileinputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info">
|
|
<callback name="query_info" throws="1">
|
|
<source-position filename="gfileinputstream.h" line="69"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22890">a #GFileInfo, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22878">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22879">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22880">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_async">
|
|
<callback name="query_info_async">
|
|
<source-position filename="gfileinputstream.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22896">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22897">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22898">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22899">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22900">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22901">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_finish">
|
|
<callback name="query_info_finish" throws="1">
|
|
<source-position filename="gfileinputstream.h" line="79"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22926">#GFileInfo.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22919">a #GFileInputStream.</doc>
|
|
<type name="FileInputStream" c:type="GFileInputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="22920">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfileinputstream.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfileinputstream.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfileinputstream.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gfileinputstream.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gfileinputstream.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="FileInputStreamPrivate" c:type="GFileInputStreamPrivate" disguised="1">
|
|
<source-position filename="gfileinputstream.h" line="48"/>
|
|
</record>
|
|
<bitfield name="FileMeasureFlags" version="2.38" glib:type-name="GFileMeasureFlags" glib:get-type="g_file_measure_flags_get_type" c:type="GFileMeasureFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="212">Flags that can be used with g_file_measure_disk_usage().</doc>
|
|
<member name="none" value="0" c:identifier="G_FILE_MEASURE_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="214">No flags set.</doc>
|
|
</member>
|
|
<member name="report_any_error" value="2" c:identifier="G_FILE_MEASURE_REPORT_ANY_ERROR" glib:nick="report-any-error">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="215">Report any error encountered
|
|
while traversing the directory tree. Normally errors are only
|
|
reported for the toplevel file.</doc>
|
|
</member>
|
|
<member name="apparent_size" value="4" c:identifier="G_FILE_MEASURE_APPARENT_SIZE" glib:nick="apparent-size">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="218">Tally usage based on apparent file
|
|
sizes. Normally, the block-size is used, if available, as this is a
|
|
more accurate representation of disk space used.
|
|
Compare with `du --apparent-size`.</doc>
|
|
</member>
|
|
<member name="no_xdev" value="8" c:identifier="G_FILE_MEASURE_NO_XDEV" glib:nick="no-xdev">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="222">Do not cross mount point boundaries.
|
|
Compare with `du -x`.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<callback name="FileMeasureProgressCallback" c:type="GFileMeasureProgressCallback" version="2.38">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="310">This callback type is used by g_file_measure_disk_usage() to make
|
|
periodic progress reports when measuring the amount of disk spaced
|
|
used by a directory.
|
|
|
|
These calls are made on a best-effort basis and not all types of
|
|
#GFile will support them. At the minimum, however, one call will
|
|
always be made immediately.
|
|
|
|
In the case that there is no support, @reporting will be set to
|
|
%FALSE (and the other values undefined) and no further calls will be
|
|
made. Otherwise, the @reporting will be %TRUE and the other values
|
|
all-zeros during the first (immediate) call. In this way, you can
|
|
know which type of progress UI to show without a delay.
|
|
|
|
For g_file_measure_disk_usage() the callback is made directly. For
|
|
g_file_measure_disk_usage_async() the callback is made via the
|
|
default main context of the calling thread (ie: the same way that the
|
|
final async result would be reported).
|
|
|
|
@current_size is in the same units as requested by the operation (see
|
|
%G_FILE_MEASURE_APPARENT_SIZE).
|
|
|
|
The frequency of the updates is implementation defined, but is
|
|
ideally about once every 200ms.
|
|
|
|
The last progress callback may or may not be equal to the final
|
|
result. Always check the async result to get the final value.</doc>
|
|
<source-position filename="giotypes.h" line="348"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="reporting" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="312">%TRUE if more reports will come</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="current_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="313">the current cumulative size measurement</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="num_dirs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="314">the number of directories visited so far</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="num_files" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="315">the number of non-directory files encountered</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="316">the data passed to the original request for this callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="FileMonitor" c:symbol-prefix="file_monitor" c:type="GFileMonitor" parent="GObject.Object" abstract="1" glib:type-name="GFileMonitor" glib:get-type="g_file_monitor_get_type" glib:type-struct="FileMonitorClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6476">Monitors a file or directory for changes.
|
|
|
|
To obtain a #GFileMonitor for a file or directory, use
|
|
g_file_monitor(), g_file_monitor_file(), or
|
|
g_file_monitor_directory().
|
|
|
|
To get informed about changes to the file or directory you are
|
|
monitoring, connect to the #GFileMonitor::changed signal. The
|
|
signal will be emitted in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread that the monitor was created in
|
|
(though if the global default main context is blocked, this may
|
|
cause notifications to be blocked even if the thread-default
|
|
context is still running).</doc>
|
|
<source-position filename="gfilemonitor.h" line="75"/>
|
|
<virtual-method name="cancel" invoker="cancel">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23416">Cancels a file monitor.</doc>
|
|
<source-position filename="gfilemonitor.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23422">always %TRUE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23418">a #GFileMonitor.</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="changed">
|
|
<source-position filename="gfilemonitor.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="other_file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="event_type" transfer-ownership="none">
|
|
<type name="FileMonitorEvent" c:type="GFileMonitorEvent"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="cancel" c:identifier="g_file_monitor_cancel">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23416">Cancels a file monitor.</doc>
|
|
<source-position filename="gfilemonitor.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23422">always %TRUE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23418">a #GFileMonitor.</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="emit_event" c:identifier="g_file_monitor_emit_event">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23453">Emits the #GFileMonitor::changed signal if a change
|
|
has taken place. Should be called from file monitor
|
|
implementations only.
|
|
|
|
Implementations are responsible to call this method from the
|
|
[thread-default main context][g-main-context-push-thread-default] of the
|
|
thread that the monitor was created in.</doc>
|
|
<source-position filename="gfilemonitor.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23455">a #GFileMonitor.</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="child" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23456">a #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="other_file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23457">a #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="event_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23458">a set of #GFileMonitorEvent flags.</doc>
|
|
<type name="FileMonitorEvent" c:type="GFileMonitorEvent"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_cancelled" c:identifier="g_file_monitor_is_cancelled">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23499">Returns whether the monitor is canceled.</doc>
|
|
<source-position filename="gfilemonitor.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23505">%TRUE if monitor is canceled. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23501">a #GFileMonitor</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_rate_limit" c:identifier="g_file_monitor_set_rate_limit">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23509">Sets the rate limit to which the @monitor will report
|
|
consecutive change events to the same file.</doc>
|
|
<source-position filename="gfilemonitor.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23511">a #GFileMonitor.</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="limit_msecs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23512">a non-negative integer with the limit in milliseconds
|
|
to poll for changes</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="cancelled" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="rate-limit" writable="1" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="FileMonitorPrivate" c:type="GFileMonitorPrivate*"/>
|
|
</field>
|
|
<glib:signal name="changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1784">Emitted when @file has been changed.
|
|
|
|
If using %G_FILE_MONITOR_WATCH_MOVES on a directory monitor, and
|
|
the information is available (and if supported by the backend),
|
|
@event_type may be %G_FILE_MONITOR_EVENT_RENAMED,
|
|
%G_FILE_MONITOR_EVENT_MOVED_IN or %G_FILE_MONITOR_EVENT_MOVED_OUT.
|
|
|
|
In all cases @file will be a child of the monitored directory. For
|
|
renames, @file will be the old name and @other_file is the new
|
|
name. For "moved in" events, @file is the name of the file that
|
|
appeared and @other_file is the old name that it was moved from (in
|
|
another directory). For "moved out" events, @file is the name of
|
|
the file that used to be in this directory and @other_file is the
|
|
name of the file at its new location.
|
|
|
|
It makes sense to treat %G_FILE_MONITOR_EVENT_MOVED_IN as
|
|
equivalent to %G_FILE_MONITOR_EVENT_CREATED and
|
|
%G_FILE_MONITOR_EVENT_MOVED_OUT as equivalent to
|
|
%G_FILE_MONITOR_EVENT_DELETED, with extra information.
|
|
%G_FILE_MONITOR_EVENT_RENAMED is equivalent to a delete/create
|
|
pair. This is exactly how the events will be reported in the case
|
|
that the %G_FILE_MONITOR_WATCH_MOVES flag is not in use.
|
|
|
|
If using the deprecated flag %G_FILE_MONITOR_SEND_MOVED flag and @event_type is
|
|
#G_FILE_MONITOR_EVENT_MOVED, @file will be set to a #GFile containing the
|
|
old path, and @other_file will be set to a #GFile containing the new path.
|
|
|
|
In all the other cases, @other_file will be set to #NULL.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1787">a #GFile.</doc>
|
|
<type name="File"/>
|
|
</parameter>
|
|
<parameter name="other_file" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1788">a #GFile or #NULL.</doc>
|
|
<type name="File"/>
|
|
</parameter>
|
|
<parameter name="event_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1789">a #GFileMonitorEvent.</doc>
|
|
<type name="FileMonitorEvent"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="FileMonitorClass" c:type="GFileMonitorClass" glib:is-gtype-struct-for="FileMonitor">
|
|
<source-position filename="gfilemonitor.h" line="75"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="changed">
|
|
<callback name="changed">
|
|
<source-position filename="gfilemonitor.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="monitor" transfer-ownership="none">
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</parameter>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="other_file" transfer-ownership="none">
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
<parameter name="event_type" transfer-ownership="none">
|
|
<type name="FileMonitorEvent" c:type="GFileMonitorEvent"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="cancel">
|
|
<callback name="cancel">
|
|
<source-position filename="gfilemonitor.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23422">always %TRUE</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23418">a #GFileMonitor.</doc>
|
|
<type name="FileMonitor" c:type="GFileMonitor*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfilemonitor.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfilemonitor.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfilemonitor.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gfilemonitor.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gfilemonitor.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<enumeration name="FileMonitorEvent" glib:type-name="GFileMonitorEvent" glib:get-type="g_file_monitor_event_get_type" c:type="GFileMonitorEvent">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="402">Specifies what type of event a monitor event is.</doc>
|
|
<member name="changed" value="0" c:identifier="G_FILE_MONITOR_EVENT_CHANGED" glib:nick="changed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="404">a file changed.</doc>
|
|
</member>
|
|
<member name="changes_done_hint" value="1" c:identifier="G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT" glib:nick="changes-done-hint">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="405">a hint that this was probably the last change in a set of changes.</doc>
|
|
</member>
|
|
<member name="deleted" value="2" c:identifier="G_FILE_MONITOR_EVENT_DELETED" glib:nick="deleted">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="406">a file was deleted.</doc>
|
|
</member>
|
|
<member name="created" value="3" c:identifier="G_FILE_MONITOR_EVENT_CREATED" glib:nick="created">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="407">a file was created.</doc>
|
|
</member>
|
|
<member name="attribute_changed" value="4" c:identifier="G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED" glib:nick="attribute-changed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="408">a file attribute was changed.</doc>
|
|
</member>
|
|
<member name="pre_unmount" value="5" c:identifier="G_FILE_MONITOR_EVENT_PRE_UNMOUNT" glib:nick="pre-unmount">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="409">the file location will soon be unmounted.</doc>
|
|
</member>
|
|
<member name="unmounted" value="6" c:identifier="G_FILE_MONITOR_EVENT_UNMOUNTED" glib:nick="unmounted">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="410">the file location was unmounted.</doc>
|
|
</member>
|
|
<member name="moved" value="7" c:identifier="G_FILE_MONITOR_EVENT_MOVED" glib:nick="moved">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="411">the file was moved -- only sent if the
|
|
(deprecated) %G_FILE_MONITOR_SEND_MOVED flag is set</doc>
|
|
</member>
|
|
<member name="renamed" value="8" c:identifier="G_FILE_MONITOR_EVENT_RENAMED" glib:nick="renamed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="413">the file was renamed within the
|
|
current directory -- only sent if the %G_FILE_MONITOR_WATCH_MOVES
|
|
flag is set. Since: 2.46.</doc>
|
|
</member>
|
|
<member name="moved_in" value="9" c:identifier="G_FILE_MONITOR_EVENT_MOVED_IN" glib:nick="moved-in">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="416">the file was moved into the
|
|
monitored directory from another location -- only sent if the
|
|
%G_FILE_MONITOR_WATCH_MOVES flag is set. Since: 2.46.</doc>
|
|
</member>
|
|
<member name="moved_out" value="10" c:identifier="G_FILE_MONITOR_EVENT_MOVED_OUT" glib:nick="moved-out">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="419">the file was moved out of the
|
|
monitored directory to another location -- only sent if the
|
|
%G_FILE_MONITOR_WATCH_MOVES flag is set. Since: 2.46</doc>
|
|
</member>
|
|
</enumeration>
|
|
<bitfield name="FileMonitorFlags" glib:type-name="GFileMonitorFlags" glib:get-type="g_file_monitor_flags_get_type" c:type="GFileMonitorFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="323">Flags used to set what a #GFileMonitor will watch for.</doc>
|
|
<member name="none" value="0" c:identifier="G_FILE_MONITOR_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="325">No flags set.</doc>
|
|
</member>
|
|
<member name="watch_mounts" value="1" c:identifier="G_FILE_MONITOR_WATCH_MOUNTS" glib:nick="watch-mounts">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="326">Watch for mount events.</doc>
|
|
</member>
|
|
<member name="send_moved" value="2" c:identifier="G_FILE_MONITOR_SEND_MOVED" glib:nick="send-moved">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="327">Pair DELETED and CREATED events caused
|
|
by file renames (moves) and send a single G_FILE_MONITOR_EVENT_MOVED
|
|
event instead (NB: not supported on all backends; the default
|
|
behaviour -without specifying this flag- is to send single DELETED
|
|
and CREATED events). Deprecated since 2.46: use
|
|
%G_FILE_MONITOR_WATCH_MOVES instead.</doc>
|
|
</member>
|
|
<member name="watch_hard_links" value="4" c:identifier="G_FILE_MONITOR_WATCH_HARD_LINKS" glib:nick="watch-hard-links">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="333">Watch for changes to the file made
|
|
via another hard link. Since 2.36.</doc>
|
|
</member>
|
|
<member name="watch_moves" value="8" c:identifier="G_FILE_MONITOR_WATCH_MOVES" glib:nick="watch-moves">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="335">Watch for rename operations on a
|
|
monitored directory. This causes %G_FILE_MONITOR_EVENT_RENAMED,
|
|
%G_FILE_MONITOR_EVENT_MOVED_IN and %G_FILE_MONITOR_EVENT_MOVED_OUT
|
|
events to be emitted when possible. Since: 2.46.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="FileMonitorPrivate" c:type="GFileMonitorPrivate" disguised="1">
|
|
<source-position filename="gfilemonitor.h" line="40"/>
|
|
</record>
|
|
<class name="FileOutputStream" c:symbol-prefix="file_output_stream" c:type="GFileOutputStream" parent="OutputStream" glib:type-name="GFileOutputStream" glib:get-type="g_file_output_stream_get_type" glib:type-struct="FileOutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6509">GFileOutputStream provides output streams that write their
|
|
content to a file.
|
|
|
|
GFileOutputStream implements #GSeekable, which allows the output
|
|
stream to jump to arbitrary positions in the file and to truncate
|
|
the file, provided the filesystem of the file supports these
|
|
operations.
|
|
|
|
To find the position of a file output stream, use g_seekable_tell().
|
|
To find out if a file output stream supports seeking, use
|
|
g_seekable_can_seek().To position a file output stream, use
|
|
g_seekable_seek(). To find out if a file output stream supports
|
|
truncating, use g_seekable_can_truncate(). To truncate a file output
|
|
stream, use g_seekable_truncate().</doc>
|
|
<source-position filename="gfileoutputstream.h" line="95"/>
|
|
<implements name="Seekable"/>
|
|
<virtual-method name="can_seek">
|
|
<source-position filename="gfileoutputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_truncate">
|
|
<source-position filename="gfileoutputstream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_etag" invoker="get_etag">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23837">Gets the entity tag for the file when it has been written.
|
|
This must be called after the stream has been written
|
|
and closed, as the etag can change while writing.</doc>
|
|
<source-position filename="gfileoutputstream.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23845">the entity tag for the stream.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23839">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info" invoker="query_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23849">Queries a file output stream for the given @attributes.
|
|
This function blocks while querying the stream. For the asynchronous
|
|
version of this function, see g_file_output_stream_query_info_async().
|
|
While the stream is blocked, the stream will set the pending flag
|
|
internally, and any other operations on the stream will fail with
|
|
%G_IO_ERROR_PENDING.
|
|
|
|
Can fail if the stream was already closed (with @error being set to
|
|
%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
|
|
set to %G_IO_ERROR_PENDING), or if querying info is not supported for
|
|
the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In
|
|
all cases of failure, %NULL will be returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
|
|
be returned.</doc>
|
|
<source-position filename="gfileoutputstream.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23874">a #GFileInfo for the @stream, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23851">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23852">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23853">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_async" invoker="query_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23878">Asynchronously queries the @stream for a #GFileInfo. When completed,
|
|
@callback will be called with a #GAsyncResult which can be used to
|
|
finish the operation with g_file_output_stream_query_info_finish().
|
|
|
|
For the synchronous version of this function, see
|
|
g_file_output_stream_query_info().</doc>
|
|
<source-position filename="gfileoutputstream.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23880">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23881">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23882">the [I/O priority][gio-GIOScheduler] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23883">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23884">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23885">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="query_info_finish" invoker="query_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23896">Finalizes the asynchronous query started
|
|
by g_file_output_stream_query_info_async().</doc>
|
|
<source-position filename="gfileoutputstream.h" line="84"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23905">A #GFileInfo for the finished query.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23898">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23899">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="seek" throws="1">
|
|
<source-position filename="gfileoutputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="tell">
|
|
<source-position filename="gfileoutputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="truncate_fn" throws="1">
|
|
<source-position filename="gfileoutputstream.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_etag" c:identifier="g_file_output_stream_get_etag">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23837">Gets the entity tag for the file when it has been written.
|
|
This must be called after the stream has been written
|
|
and closed, as the etag can change while writing.</doc>
|
|
<source-position filename="gfileoutputstream.h" line="118"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23845">the entity tag for the stream.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23839">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info" c:identifier="g_file_output_stream_query_info" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23849">Queries a file output stream for the given @attributes.
|
|
This function blocks while querying the stream. For the asynchronous
|
|
version of this function, see g_file_output_stream_query_info_async().
|
|
While the stream is blocked, the stream will set the pending flag
|
|
internally, and any other operations on the stream will fail with
|
|
%G_IO_ERROR_PENDING.
|
|
|
|
Can fail if the stream was already closed (with @error being set to
|
|
%G_IO_ERROR_CLOSED), the stream has pending operations (with @error being
|
|
set to %G_IO_ERROR_PENDING), or if querying info is not supported for
|
|
the stream's interface (with @error being set to %G_IO_ERROR_NOT_SUPPORTED). In
|
|
all cases of failure, %NULL will be returned.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be set, and %NULL will
|
|
be returned.</doc>
|
|
<source-position filename="gfileoutputstream.h" line="102"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23874">a #GFileInfo for the @stream, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23851">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23852">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23853">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_async" c:identifier="g_file_output_stream_query_info_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23878">Asynchronously queries the @stream for a #GFileInfo. When completed,
|
|
@callback will be called with a #GAsyncResult which can be used to
|
|
finish the operation with g_file_output_stream_query_info_finish().
|
|
|
|
For the synchronous version of this function, see
|
|
g_file_output_stream_query_info().</doc>
|
|
<source-position filename="gfileoutputstream.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23880">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23881">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23882">the [I/O priority][gio-GIOScheduler] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23883">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23884">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23885">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="query_info_finish" c:identifier="g_file_output_stream_query_info_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23896">Finalizes the asynchronous query started
|
|
by g_file_output_stream_query_info_async().</doc>
|
|
<source-position filename="gfileoutputstream.h" line="114"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23905">A #GFileInfo for the finished query.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23898">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23899">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="OutputStream" c:type="GOutputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="FileOutputStreamPrivate" c:type="GFileOutputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="FileOutputStreamClass" c:type="GFileOutputStreamClass" glib:is-gtype-struct-for="FileOutputStream">
|
|
<source-position filename="gfileoutputstream.h" line="95"/>
|
|
<field name="parent_class">
|
|
<type name="OutputStreamClass" c:type="GOutputStreamClass"/>
|
|
</field>
|
|
<field name="tell">
|
|
<callback name="tell">
|
|
<source-position filename="gfileoutputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_seek">
|
|
<callback name="can_seek">
|
|
<source-position filename="gfileoutputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="seek">
|
|
<callback name="seek" throws="1">
|
|
<source-position filename="gfileoutputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_truncate">
|
|
<callback name="can_truncate">
|
|
<source-position filename="gfileoutputstream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="truncate_fn">
|
|
<callback name="truncate_fn" throws="1">
|
|
<source-position filename="gfileoutputstream.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info">
|
|
<callback name="query_info" throws="1">
|
|
<source-position filename="gfileoutputstream.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23874">a #GFileInfo for the @stream, or %NULL on error.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23851">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23852">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23853">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_async">
|
|
<callback name="query_info_async">
|
|
<source-position filename="gfileoutputstream.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23880">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="attributes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23881">a file attribute query string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23882">the [I/O priority][gio-GIOScheduler] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23883">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23884">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23885">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="query_info_finish">
|
|
<callback name="query_info_finish" throws="1">
|
|
<source-position filename="gfileoutputstream.h" line="84"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23905">A #GFileInfo for the finished query.</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23898">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23899">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_etag">
|
|
<callback name="get_etag">
|
|
<source-position filename="gfileoutputstream.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23845">the entity tag for the stream.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23839">a #GFileOutputStream.</doc>
|
|
<type name="FileOutputStream" c:type="GFileOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfileoutputstream.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfileoutputstream.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfileoutputstream.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gfileoutputstream.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gfileoutputstream.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="FileOutputStreamPrivate" c:type="GFileOutputStreamPrivate" disguised="1">
|
|
<source-position filename="gfileoutputstream.h" line="48"/>
|
|
</record>
|
|
<callback name="FileProgressCallback" c:type="GFileProgressCallback">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="279">When doing file operations that may take a while, such as moving
|
|
a file or copying a file, a progress callback is used to pass how
|
|
far along that operation is to the application.</doc>
|
|
<source-position filename="giotypes.h" line="289"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="current_num_bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="281">the current number of bytes in the operation.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="total_num_bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="282">the total number of bytes in the operation.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="283">user data passed to the callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<bitfield name="FileQueryInfoFlags" glib:type-name="GFileQueryInfoFlags" glib:get-type="g_file_query_info_flags_get_type" c:type="GFileQueryInfoFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="177">Flags used when querying a #GFileInfo.</doc>
|
|
<member name="none" value="0" c:identifier="G_FILE_QUERY_INFO_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="179">No flags set.</doc>
|
|
</member>
|
|
<member name="nofollow_symlinks" value="1" c:identifier="G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS" glib:nick="nofollow-symlinks">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="180">Don't follow symlinks.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<callback name="FileReadMoreCallback" c:type="GFileReadMoreCallback">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="293">When loading the partial contents of a file with g_file_load_partial_contents_async(),
|
|
it may become necessary to determine if any more data from the file should be loaded.
|
|
A #GFileReadMoreCallback function facilitates this by returning %TRUE if more data
|
|
should be read, or %FALSE otherwise.</doc>
|
|
<source-position filename="giotypes.h" line="306"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="304">%TRUE if more data should be read back. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file_contents" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="295">the data as currently read.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="file_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="296">the size of the data currently read.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="callback_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="297">data passed to the callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<enumeration name="FileType" glib:type-name="GFileType" glib:get-type="g_file_type_get_type" c:type="GFileType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="351">Indicates the file's on-disk type.
|
|
|
|
On Windows systems a file will never have %G_FILE_TYPE_SYMBOLIC_LINK type;
|
|
use #GFileInfo and %G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK to determine
|
|
whether a file is a symlink or not. This is due to the fact that NTFS does
|
|
not have a single filesystem object type for symbolic links - it has
|
|
files that symlink to files, and directories that symlink to directories.
|
|
#GFileType enumeration cannot precisely represent this important distinction,
|
|
which is why all Windows symlinks will continue to be reported as
|
|
%G_FILE_TYPE_REGULAR or %G_FILE_TYPE_DIRECTORY.</doc>
|
|
<member name="unknown" value="0" c:identifier="G_FILE_TYPE_UNKNOWN" glib:nick="unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="353">File's type is unknown.</doc>
|
|
</member>
|
|
<member name="regular" value="1" c:identifier="G_FILE_TYPE_REGULAR" glib:nick="regular">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="354">File handle represents a regular file.</doc>
|
|
</member>
|
|
<member name="directory" value="2" c:identifier="G_FILE_TYPE_DIRECTORY" glib:nick="directory">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="355">File handle represents a directory.</doc>
|
|
</member>
|
|
<member name="symbolic_link" value="3" c:identifier="G_FILE_TYPE_SYMBOLIC_LINK" glib:nick="symbolic-link">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="356">File handle represents a symbolic link
|
|
(Unix systems).</doc>
|
|
</member>
|
|
<member name="special" value="4" c:identifier="G_FILE_TYPE_SPECIAL" glib:nick="special">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="358">File is a "special" file, such as a socket, fifo,
|
|
block device, or character device.</doc>
|
|
</member>
|
|
<member name="shortcut" value="5" c:identifier="G_FILE_TYPE_SHORTCUT" glib:nick="shortcut">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="360">File is a shortcut (Windows systems).</doc>
|
|
</member>
|
|
<member name="mountable" value="6" c:identifier="G_FILE_TYPE_MOUNTABLE" glib:nick="mountable">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="361">File is a mountable location.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="FilenameCompleter" c:symbol-prefix="filename_completer" c:type="GFilenameCompleter" parent="GObject.Object" glib:type-name="GFilenameCompleter" glib:get-type="g_filename_completer_get_type" glib:type-struct="FilenameCompleterClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6498">Completes partial file and directory names given a partial string by
|
|
looking in the file system for clues. Can return a list of possible
|
|
completion strings for widget implementations.</doc>
|
|
<source-position filename="gfilenamecompleter.h" line="59"/>
|
|
<constructor name="new" c:identifier="g_filename_completer_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25186">Creates a new filename completer.</doc>
|
|
<source-position filename="gfilenamecompleter.h" line="65"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25191">a #GFilenameCompleter.</doc>
|
|
<type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<virtual-method name="got_completion_data">
|
|
<source-position filename="gfilenamecompleter.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="filename_completer" transfer-ownership="none">
|
|
<type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_completion_suffix" c:identifier="g_filename_completer_get_completion_suffix">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25161">Obtains a completion for @initial_text from @completer.</doc>
|
|
<source-position filename="gfilenamecompleter.h" line="68"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25168">a completed string, or %NULL if no completion exists.
|
|
This string is not owned by GIO, so remember to g_free() it
|
|
when finished.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="completer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25163">the filename completer.</doc>
|
|
<type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
|
|
</instance-parameter>
|
|
<parameter name="initial_text" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25164">text to be completed.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_completions" c:identifier="g_filename_completer_get_completions">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25174">Gets an array of completion strings for a given initial text.</doc>
|
|
<source-position filename="gfilenamecompleter.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25181">array of strings with possible completions for @initial_text.
|
|
This array must be freed by g_strfreev() when finished.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="completer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25176">the filename completer.</doc>
|
|
<type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
|
|
</instance-parameter>
|
|
<parameter name="initial_text" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25177">text to be completed.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_dirs_only" c:identifier="g_filename_completer_set_dirs_only">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25195">If @dirs_only is %TRUE, @completer will only
|
|
complete directory names, and not file names.</doc>
|
|
<source-position filename="gfilenamecompleter.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="completer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25197">the filename completer.</doc>
|
|
<type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
|
|
</instance-parameter>
|
|
<parameter name="dirs_only" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25198">a #gboolean.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="got-completion-data" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1822">Emitted when the file name completion information comes available.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="FilenameCompleterClass" c:type="GFilenameCompleterClass" glib:is-gtype-struct-for="FilenameCompleter">
|
|
<source-position filename="gfilenamecompleter.h" line="59"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="got_completion_data">
|
|
<callback name="got_completion_data">
|
|
<source-position filename="gfilenamecompleter.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="filename_completer" transfer-ownership="none">
|
|
<type name="FilenameCompleter" c:type="GFilenameCompleter*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfilenamecompleter.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfilenamecompleter.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfilenamecompleter.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<enumeration name="FilesystemPreviewType" glib:type-name="GFilesystemPreviewType" glib:get-type="g_filesystem_preview_type_get_type" c:type="GFilesystemPreviewType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="385">Indicates a hint from the file system whether files should be
|
|
previewed in a file manager. Returned as the value of the key
|
|
#G_FILE_ATTRIBUTE_FILESYSTEM_USE_PREVIEW.</doc>
|
|
<member name="if_always" value="0" c:identifier="G_FILESYSTEM_PREVIEW_TYPE_IF_ALWAYS" glib:nick="if-always">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="387">Only preview files if user has explicitly requested it.</doc>
|
|
</member>
|
|
<member name="if_local" value="1" c:identifier="G_FILESYSTEM_PREVIEW_TYPE_IF_LOCAL" glib:nick="if-local">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="388">Preview files if user has requested preview of "local" files.</doc>
|
|
</member>
|
|
<member name="never" value="2" c:identifier="G_FILESYSTEM_PREVIEW_TYPE_NEVER" glib:nick="never">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="389">Never preview files.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="FilterInputStream" c:symbol-prefix="filter_input_stream" c:type="GFilterInputStream" parent="InputStream" abstract="1" glib:type-name="GFilterInputStream" glib:get-type="g_filter_input_stream_get_type" glib:type-struct="FilterInputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6532">Base class for input stream implementations that perform some
|
|
kind of filtering operation on a base stream. Typical examples
|
|
of filtering operations are character set conversion, compression
|
|
and byte order flipping.</doc>
|
|
<source-position filename="gfilterinputstream.h" line="63"/>
|
|
<method name="get_base_stream" c:identifier="g_filter_input_stream_get_base_stream">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25205">Gets the base stream for the filter stream.</doc>
|
|
<source-position filename="gfilterinputstream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25211">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25207">a #GFilterInputStream.</doc>
|
|
<type name="FilterInputStream" c:type="GFilterInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_close_base_stream" c:identifier="g_filter_input_stream_get_close_base_stream">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25215">Returns whether the base stream will be closed when @stream is
|
|
closed.</doc>
|
|
<source-position filename="gfilterinputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25222">%TRUE if the base stream will be closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25217">a #GFilterInputStream.</doc>
|
|
<type name="FilterInputStream" c:type="GFilterInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_close_base_stream" c:identifier="g_filter_input_stream_set_close_base_stream">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25226">Sets whether the base stream will be closed when @stream is closed.</doc>
|
|
<source-position filename="gfilterinputstream.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25228">a #GFilterInputStream.</doc>
|
|
<type name="FilterInputStream" c:type="GFilterInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="close_base" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25229">%TRUE to close the base stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="base-stream" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="InputStream"/>
|
|
</property>
|
|
<property name="close-base-stream" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="InputStream" c:type="GInputStream"/>
|
|
</field>
|
|
<field name="base_stream">
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</field>
|
|
</class>
|
|
<record name="FilterInputStreamClass" c:type="GFilterInputStreamClass" glib:is-gtype-struct-for="FilterInputStream">
|
|
<source-position filename="gfilterinputstream.h" line="63"/>
|
|
<field name="parent_class">
|
|
<type name="InputStreamClass" c:type="GInputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfilterinputstream.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfilterinputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfilterinputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="FilterOutputStream" c:symbol-prefix="filter_output_stream" c:type="GFilterOutputStream" parent="OutputStream" abstract="1" glib:type-name="GFilterOutputStream" glib:get-type="g_filter_output_stream_get_type" glib:type-struct="FilterOutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6544">Base class for output stream implementations that perform some
|
|
kind of filtering operation on a base stream. Typical examples
|
|
of filtering operations are character set conversion, compression
|
|
and byte order flipping.</doc>
|
|
<source-position filename="gfilteroutputstream.h" line="63"/>
|
|
<method name="get_base_stream" c:identifier="g_filter_output_stream_get_base_stream">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25235">Gets the base stream for the filter stream.</doc>
|
|
<source-position filename="gfilteroutputstream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25241">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25237">a #GFilterOutputStream.</doc>
|
|
<type name="FilterOutputStream" c:type="GFilterOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_close_base_stream" c:identifier="g_filter_output_stream_get_close_base_stream">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25245">Returns whether the base stream will be closed when @stream is
|
|
closed.</doc>
|
|
<source-position filename="gfilteroutputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25252">%TRUE if the base stream will be closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25247">a #GFilterOutputStream.</doc>
|
|
<type name="FilterOutputStream" c:type="GFilterOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_close_base_stream" c:identifier="g_filter_output_stream_set_close_base_stream">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25256">Sets whether the base stream will be closed when @stream is closed.</doc>
|
|
<source-position filename="gfilteroutputstream.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25258">a #GFilterOutputStream.</doc>
|
|
<type name="FilterOutputStream" c:type="GFilterOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="close_base" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25259">%TRUE to close the base stream.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="base-stream" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="OutputStream"/>
|
|
</property>
|
|
<property name="close-base-stream" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="OutputStream" c:type="GOutputStream"/>
|
|
</field>
|
|
<field name="base_stream">
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</field>
|
|
</class>
|
|
<record name="FilterOutputStreamClass" c:type="GFilterOutputStreamClass" glib:is-gtype-struct-for="FilterOutputStream">
|
|
<source-position filename="gfilteroutputstream.h" line="63"/>
|
|
<field name="parent_class">
|
|
<type name="OutputStreamClass" c:type="GOutputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gfilteroutputstream.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gfilteroutputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gfilteroutputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<function-macro name="ICON" c:identifier="G_ICON" introspectable="0">
|
|
<source-position filename="gicon.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ICON_GET_IFACE" c:identifier="G_ICON_GET_IFACE" introspectable="0">
|
|
<source-position filename="gicon.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_ADDRESS" c:identifier="G_INET_ADDRESS" introspectable="0">
|
|
<source-position filename="ginetaddress.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_ADDRESS_CLASS" c:identifier="G_INET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="ginetaddress.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_ADDRESS_GET_CLASS" c:identifier="G_INET_ADDRESS_GET_CLASS" introspectable="0">
|
|
<source-position filename="ginetaddress.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_ADDRESS_MASK" c:identifier="G_INET_ADDRESS_MASK" introspectable="0">
|
|
<source-position filename="ginetaddressmask.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_ADDRESS_MASK_CLASS" c:identifier="G_INET_ADDRESS_MASK_CLASS" introspectable="0">
|
|
<source-position filename="ginetaddressmask.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_ADDRESS_MASK_GET_CLASS" c:identifier="G_INET_ADDRESS_MASK_GET_CLASS" introspectable="0">
|
|
<source-position filename="ginetaddressmask.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_SOCKET_ADDRESS" c:identifier="G_INET_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="ginetsocketaddress.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_SOCKET_ADDRESS_CLASS" c:identifier="G_INET_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="ginetsocketaddress.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INET_SOCKET_ADDRESS_GET_CLASS" c:identifier="G_INET_SOCKET_ADDRESS_GET_CLASS" introspectable="0">
|
|
<source-position filename="ginetsocketaddress.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INITABLE" c:identifier="G_INITABLE" introspectable="0">
|
|
<source-position filename="ginitable.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INITABLE_GET_IFACE" c:identifier="G_INITABLE_GET_IFACE" introspectable="0">
|
|
<source-position filename="ginitable.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INPUT_STREAM" c:identifier="G_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="ginputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INPUT_STREAM_CLASS" c:identifier="G_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="ginputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="INPUT_STREAM_GET_CLASS" c:identifier="G_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="ginputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<enumeration name="IOErrorEnum" glib:type-name="GIOErrorEnum" glib:get-type="g_io_error_enum_get_type" c:type="GIOErrorEnum" glib:error-domain="g-io-error-quark">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="445">Error codes returned by GIO functions.
|
|
|
|
Note that this domain may be extended in future GLib releases. In
|
|
general, new error codes either only apply to new APIs, or else
|
|
replace %G_IO_ERROR_FAILED in cases that were not explicitly
|
|
distinguished before. You should therefore avoid writing code like
|
|
|[<!-- language="C" -->
|
|
if (g_error_matches (error, G_IO_ERROR, G_IO_ERROR_FAILED))
|
|
{
|
|
// Assume that this is EPRINTERONFIRE
|
|
...
|
|
}
|
|
]|
|
|
but should instead treat all unrecognized error codes the same as
|
|
#G_IO_ERROR_FAILED.
|
|
|
|
See also #GPollableReturn for a cheaper way of returning
|
|
%G_IO_ERROR_WOULD_BLOCK to callers without allocating a #GError.</doc>
|
|
<member name="failed" value="0" c:identifier="G_IO_ERROR_FAILED" glib:nick="failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="447">Generic error condition for when an operation fails
|
|
and no more specific #GIOErrorEnum value is defined.</doc>
|
|
</member>
|
|
<member name="not_found" value="1" c:identifier="G_IO_ERROR_NOT_FOUND" glib:nick="not-found">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="449">File not found.</doc>
|
|
</member>
|
|
<member name="exists" value="2" c:identifier="G_IO_ERROR_EXISTS" glib:nick="exists">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="450">File already exists.</doc>
|
|
</member>
|
|
<member name="is_directory" value="3" c:identifier="G_IO_ERROR_IS_DIRECTORY" glib:nick="is-directory">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="451">File is a directory.</doc>
|
|
</member>
|
|
<member name="not_directory" value="4" c:identifier="G_IO_ERROR_NOT_DIRECTORY" glib:nick="not-directory">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="452">File is not a directory.</doc>
|
|
</member>
|
|
<member name="not_empty" value="5" c:identifier="G_IO_ERROR_NOT_EMPTY" glib:nick="not-empty">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="453">File is a directory that isn't empty.</doc>
|
|
</member>
|
|
<member name="not_regular_file" value="6" c:identifier="G_IO_ERROR_NOT_REGULAR_FILE" glib:nick="not-regular-file">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="454">File is not a regular file.</doc>
|
|
</member>
|
|
<member name="not_symbolic_link" value="7" c:identifier="G_IO_ERROR_NOT_SYMBOLIC_LINK" glib:nick="not-symbolic-link">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="455">File is not a symbolic link.</doc>
|
|
</member>
|
|
<member name="not_mountable_file" value="8" c:identifier="G_IO_ERROR_NOT_MOUNTABLE_FILE" glib:nick="not-mountable-file">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="456">File cannot be mounted.</doc>
|
|
</member>
|
|
<member name="filename_too_long" value="9" c:identifier="G_IO_ERROR_FILENAME_TOO_LONG" glib:nick="filename-too-long">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="457">Filename is too many characters.</doc>
|
|
</member>
|
|
<member name="invalid_filename" value="10" c:identifier="G_IO_ERROR_INVALID_FILENAME" glib:nick="invalid-filename">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="458">Filename is invalid or contains invalid characters.</doc>
|
|
</member>
|
|
<member name="too_many_links" value="11" c:identifier="G_IO_ERROR_TOO_MANY_LINKS" glib:nick="too-many-links">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="459">File contains too many symbolic links.</doc>
|
|
</member>
|
|
<member name="no_space" value="12" c:identifier="G_IO_ERROR_NO_SPACE" glib:nick="no-space">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="460">No space left on drive.</doc>
|
|
</member>
|
|
<member name="invalid_argument" value="13" c:identifier="G_IO_ERROR_INVALID_ARGUMENT" glib:nick="invalid-argument">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="461">Invalid argument.</doc>
|
|
</member>
|
|
<member name="permission_denied" value="14" c:identifier="G_IO_ERROR_PERMISSION_DENIED" glib:nick="permission-denied">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="462">Permission denied.</doc>
|
|
</member>
|
|
<member name="not_supported" value="15" c:identifier="G_IO_ERROR_NOT_SUPPORTED" glib:nick="not-supported">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="463">Operation (or one of its parameters) not supported</doc>
|
|
</member>
|
|
<member name="not_mounted" value="16" c:identifier="G_IO_ERROR_NOT_MOUNTED" glib:nick="not-mounted">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="464">File isn't mounted.</doc>
|
|
</member>
|
|
<member name="already_mounted" value="17" c:identifier="G_IO_ERROR_ALREADY_MOUNTED" glib:nick="already-mounted">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="465">File is already mounted.</doc>
|
|
</member>
|
|
<member name="closed" value="18" c:identifier="G_IO_ERROR_CLOSED" glib:nick="closed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="466">File was closed.</doc>
|
|
</member>
|
|
<member name="cancelled" value="19" c:identifier="G_IO_ERROR_CANCELLED" glib:nick="cancelled">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="467">Operation was cancelled. See #GCancellable.</doc>
|
|
</member>
|
|
<member name="pending" value="20" c:identifier="G_IO_ERROR_PENDING" glib:nick="pending">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="468">Operations are still pending.</doc>
|
|
</member>
|
|
<member name="read_only" value="21" c:identifier="G_IO_ERROR_READ_ONLY" glib:nick="read-only">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="469">File is read only.</doc>
|
|
</member>
|
|
<member name="cant_create_backup" value="22" c:identifier="G_IO_ERROR_CANT_CREATE_BACKUP" glib:nick="cant-create-backup">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="470">Backup couldn't be created.</doc>
|
|
</member>
|
|
<member name="wrong_etag" value="23" c:identifier="G_IO_ERROR_WRONG_ETAG" glib:nick="wrong-etag">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="471">File's Entity Tag was incorrect.</doc>
|
|
</member>
|
|
<member name="timed_out" value="24" c:identifier="G_IO_ERROR_TIMED_OUT" glib:nick="timed-out">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="472">Operation timed out.</doc>
|
|
</member>
|
|
<member name="would_recurse" value="25" c:identifier="G_IO_ERROR_WOULD_RECURSE" glib:nick="would-recurse">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="473">Operation would be recursive.</doc>
|
|
</member>
|
|
<member name="busy" value="26" c:identifier="G_IO_ERROR_BUSY" glib:nick="busy">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="474">File is busy.</doc>
|
|
</member>
|
|
<member name="would_block" value="27" c:identifier="G_IO_ERROR_WOULD_BLOCK" glib:nick="would-block">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="475">Operation would block.</doc>
|
|
</member>
|
|
<member name="host_not_found" value="28" c:identifier="G_IO_ERROR_HOST_NOT_FOUND" glib:nick="host-not-found">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="476">Host couldn't be found (remote operations).</doc>
|
|
</member>
|
|
<member name="would_merge" value="29" c:identifier="G_IO_ERROR_WOULD_MERGE" glib:nick="would-merge">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="477">Operation would merge files.</doc>
|
|
</member>
|
|
<member name="failed_handled" value="30" c:identifier="G_IO_ERROR_FAILED_HANDLED" glib:nick="failed-handled">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="478">Operation failed and a helper program has
|
|
already interacted with the user. Do not display any error dialog.</doc>
|
|
</member>
|
|
<member name="too_many_open_files" value="31" c:identifier="G_IO_ERROR_TOO_MANY_OPEN_FILES" glib:nick="too-many-open-files">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="480">The current process has too many files
|
|
open and can't open any more. Duplicate descriptors do count toward
|
|
this limit. Since 2.20</doc>
|
|
</member>
|
|
<member name="not_initialized" value="32" c:identifier="G_IO_ERROR_NOT_INITIALIZED" glib:nick="not-initialized">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="483">The object has not been initialized. Since 2.22</doc>
|
|
</member>
|
|
<member name="address_in_use" value="33" c:identifier="G_IO_ERROR_ADDRESS_IN_USE" glib:nick="address-in-use">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="484">The requested address is already in use. Since 2.22</doc>
|
|
</member>
|
|
<member name="partial_input" value="34" c:identifier="G_IO_ERROR_PARTIAL_INPUT" glib:nick="partial-input">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="485">Need more input to finish operation. Since 2.24</doc>
|
|
</member>
|
|
<member name="invalid_data" value="35" c:identifier="G_IO_ERROR_INVALID_DATA" glib:nick="invalid-data">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="486">The input data was invalid. Since 2.24</doc>
|
|
</member>
|
|
<member name="dbus_error" value="36" c:identifier="G_IO_ERROR_DBUS_ERROR" glib:nick="dbus-error">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="487">A remote object generated an error that
|
|
doesn't correspond to a locally registered #GError error
|
|
domain. Use g_dbus_error_get_remote_error() to extract the D-Bus
|
|
error name and g_dbus_error_strip_remote_error() to fix up the
|
|
message so it matches what was received on the wire. Since 2.26.</doc>
|
|
</member>
|
|
<member name="host_unreachable" value="37" c:identifier="G_IO_ERROR_HOST_UNREACHABLE" glib:nick="host-unreachable">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="492">Host unreachable. Since 2.26</doc>
|
|
</member>
|
|
<member name="network_unreachable" value="38" c:identifier="G_IO_ERROR_NETWORK_UNREACHABLE" glib:nick="network-unreachable">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="493">Network unreachable. Since 2.26</doc>
|
|
</member>
|
|
<member name="connection_refused" value="39" c:identifier="G_IO_ERROR_CONNECTION_REFUSED" glib:nick="connection-refused">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="494">Connection refused. Since 2.26</doc>
|
|
</member>
|
|
<member name="proxy_failed" value="40" c:identifier="G_IO_ERROR_PROXY_FAILED" glib:nick="proxy-failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="495">Connection to proxy server failed. Since 2.26</doc>
|
|
</member>
|
|
<member name="proxy_auth_failed" value="41" c:identifier="G_IO_ERROR_PROXY_AUTH_FAILED" glib:nick="proxy-auth-failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="496">Proxy authentication failed. Since 2.26</doc>
|
|
</member>
|
|
<member name="proxy_need_auth" value="42" c:identifier="G_IO_ERROR_PROXY_NEED_AUTH" glib:nick="proxy-need-auth">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="497">Proxy server needs authentication. Since 2.26</doc>
|
|
</member>
|
|
<member name="proxy_not_allowed" value="43" c:identifier="G_IO_ERROR_PROXY_NOT_ALLOWED" glib:nick="proxy-not-allowed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="498">Proxy connection is not allowed by ruleset.
|
|
Since 2.26</doc>
|
|
</member>
|
|
<member name="broken_pipe" value="44" c:identifier="G_IO_ERROR_BROKEN_PIPE" glib:nick="broken-pipe">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="500">Broken pipe. Since 2.36</doc>
|
|
</member>
|
|
<member name="connection_closed" value="44" c:identifier="G_IO_ERROR_CONNECTION_CLOSED" glib:nick="connection-closed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="501">Connection closed by peer. Note that this
|
|
is the same code as %G_IO_ERROR_BROKEN_PIPE; before 2.44 some
|
|
"connection closed" errors returned %G_IO_ERROR_BROKEN_PIPE, but others
|
|
returned %G_IO_ERROR_FAILED. Now they should all return the same
|
|
value, which has this more logical name. Since 2.44.</doc>
|
|
</member>
|
|
<member name="not_connected" value="45" c:identifier="G_IO_ERROR_NOT_CONNECTED" glib:nick="not-connected">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="506">Transport endpoint is not connected. Since 2.44</doc>
|
|
</member>
|
|
<member name="message_too_large" value="46" c:identifier="G_IO_ERROR_MESSAGE_TOO_LARGE" glib:nick="message-too-large">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="507">Message too large. Since 2.48.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="IOExtension" c:type="GIOExtension" disguised="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1829">#GIOExtension is an opaque data structure and can only be accessed
|
|
using the following functions.</doc>
|
|
<source-position filename="giotypes.h" line="112"/>
|
|
<method name="get_name" c:identifier="g_io_extension_get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26357">Gets the name under which @extension was registered.
|
|
|
|
Note that the same type may be registered as extension
|
|
for multiple extension points, under different names.</doc>
|
|
<source-position filename="giomodule.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26366">the name of @extension.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26359">a #GIOExtension</doc>
|
|
<type name="IOExtension" c:type="GIOExtension*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_priority" c:identifier="g_io_extension_get_priority">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26370">Gets the priority with which @extension was registered.</doc>
|
|
<source-position filename="giomodule.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26376">the priority of @extension</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26372">a #GIOExtension</doc>
|
|
<type name="IOExtension" c:type="GIOExtension*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_type" c:identifier="g_io_extension_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26380">Gets the type associated with @extension.</doc>
|
|
<source-position filename="giomodule.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26386">the type of @extension</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26382">a #GIOExtension</doc>
|
|
<type name="IOExtension" c:type="GIOExtension*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref_class" c:identifier="g_io_extension_ref_class" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26475">Gets a reference to the class for the type that is
|
|
associated with @extension.</doc>
|
|
<source-position filename="giomodule.h" line="101"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26482">the #GTypeClass for the type of @extension</doc>
|
|
<type name="GObject.TypeClass" c:type="GTypeClass*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26477">a #GIOExtension</doc>
|
|
<type name="IOExtension" c:type="GIOExtension*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<record name="IOExtensionPoint" c:type="GIOExtensionPoint" disguised="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1837">#GIOExtensionPoint is an opaque data structure and can only be accessed
|
|
using the following functions.</doc>
|
|
<source-position filename="giotypes.h" line="111"/>
|
|
<method name="get_extension_by_name" c:identifier="g_io_extension_point_get_extension_by_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26390">Finds a #GIOExtension for an extension point by name.</doc>
|
|
<source-position filename="giomodule.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26397">the #GIOExtension for @extension_point that has the
|
|
given name, or %NULL if there is no extension with that name</doc>
|
|
<type name="IOExtension" c:type="GIOExtension*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26392">a #GIOExtensionPoint</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26393">the name of the extension to get</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_extensions" c:identifier="g_io_extension_point_get_extensions">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26402">Gets a list of all extensions that implement this extension point.
|
|
The list is sorted by priority, beginning with the highest priority.</doc>
|
|
<source-position filename="giomodule.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26409">a #GList of
|
|
#GIOExtensions. The list is owned by GIO and should not be
|
|
modified.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="IOExtension"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26404">a #GIOExtensionPoint</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_required_type" c:identifier="g_io_extension_point_get_required_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26415">Gets the required type for @extension_point.</doc>
|
|
<source-position filename="giomodule.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26421">the #GType that all implementations must have,
|
|
or #G_TYPE_INVALID if the extension point has no required type</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26417">a #GIOExtensionPoint</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_required_type" c:identifier="g_io_extension_point_set_required_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26465">Sets the required type for @extension_point to @type.
|
|
All implementations must henceforth have this type.</doc>
|
|
<source-position filename="giomodule.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="extension_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26467">a #GIOExtensionPoint</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</instance-parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26468">the #GType to require</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="implement" c:identifier="g_io_extension_point_implement">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26426">Registers @type as extension for the extension point with name
|
|
@extension_point_name.
|
|
|
|
If @type has already been registered as an extension for this
|
|
extension point, the existing #GIOExtension object is returned.</doc>
|
|
<source-position filename="giomodule.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26439">a #GIOExtension object for #GType</doc>
|
|
<type name="IOExtension" c:type="GIOExtension*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="extension_point_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26428">the name of the extension point</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26429">the #GType to register as extension</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="extension_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26430">the name for the extension</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26431">the priority for the extension</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="lookup" c:identifier="g_io_extension_point_lookup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26443">Looks up an existing extension point.</doc>
|
|
<source-position filename="giomodule.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26449">the #GIOExtensionPoint, or %NULL if there
|
|
is no registered extension point with the given name.</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26445">the name of the extension point</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="register" c:identifier="g_io_extension_point_register">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26454">Registers an extension point.</doc>
|
|
<source-position filename="giomodule.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26460">the new #GIOExtensionPoint. This object is
|
|
owned by GIO and should not be freed.</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26456">The name of the extension point</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<class name="IOModule" c:symbol-prefix="io_module" c:type="GIOModule" parent="GObject.TypeModule" glib:type-name="GIOModule" glib:get-type="g_io_module_get_type" glib:type-struct="IOModuleClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6693">Provides an interface and default functions for loading and unloading
|
|
modules. This is used internally to make GIO extensible, but can also
|
|
be used by others to implement module loading.</doc>
|
|
<source-position filename="giomodule.h" line="55"/>
|
|
<implements name="GObject.TypePlugin"/>
|
|
<constructor name="new" c:identifier="g_io_module_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26486">Creates a new GIOModule that will load the specific
|
|
shared library when in use.</doc>
|
|
<source-position filename="giomodule.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26493">a #GIOModule from given @filename,
|
|
or %NULL on error.</doc>
|
|
<type name="IOModule" c:type="GIOModule*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26488">filename of the shared library module.</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="query" c:identifier="g_io_module_query" version="2.24">
|
|
<doc xml:space="preserve" filename="giomodule.h" line="147">Optional API for GIO modules to implement.
|
|
|
|
Should return a list of all the extension points that may be
|
|
implemented in this module.
|
|
|
|
This method will not be called in normal use, however it may be
|
|
called when probing existing modules and recording which extension
|
|
points that this model is used for. This means we won't have to
|
|
load and initialize this module unless its needed.
|
|
|
|
If this function is not implemented by the module the module will
|
|
always be loaded, initialized and then unloaded on application
|
|
startup so that it can register its extension points during init.
|
|
|
|
Note that a module need not actually implement all the extension
|
|
points that g_io_module_query() returns, since the exact list of
|
|
extension may depend on runtime issues. However all extension
|
|
points actually implemented must be returned by g_io_module_query()
|
|
(if defined).
|
|
|
|
When installing a module that implements g_io_module_query() you must
|
|
run gio-querymodules in order to build the cache files required for
|
|
lazy loading.
|
|
|
|
Since 2.56, this function should be named `g_io_<modulename>_query`, where
|
|
`modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
|
|
everything after the first dot removed, and with `-` replaced with `_`
|
|
throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
|
|
Using the new symbol names avoids name clashes when building modules
|
|
statically. The old symbol names continue to be supported, but cannot be used
|
|
for static builds.</doc>
|
|
<source-position filename="giomodule.h" line="189"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="giomodule.h" line="182">A %NULL-terminated array of strings,
|
|
listing the supported extension points of the module. The array
|
|
must be suitable for freeing with g_strfreev().</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
</function>
|
|
<method name="load" c:identifier="g_io_module_load">
|
|
<doc xml:space="preserve" filename="giomodule.h" line="106">Required API for GIO modules to implement.
|
|
|
|
This function is run after the module has been loaded into GIO,
|
|
to initialize the module. Typically, this function will call
|
|
g_io_extension_point_implement().
|
|
|
|
Since 2.56, this function should be named `g_io_<modulename>_load`, where
|
|
`modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
|
|
everything after the first dot removed, and with `-` replaced with `_`
|
|
throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
|
|
Using the new symbol names avoids name clashes when building modules
|
|
statically. The old symbol names continue to be supported, but cannot be used
|
|
for static builds.</doc>
|
|
<source-position filename="giomodule.h" line="125"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="module" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giomodule.h" line="108">a #GIOModule.</doc>
|
|
<type name="IOModule" c:type="GIOModule*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unload" c:identifier="g_io_module_unload">
|
|
<doc xml:space="preserve" filename="giomodule.h" line="127">Required API for GIO modules to implement.
|
|
|
|
This function is run when the module is being unloaded from GIO,
|
|
to finalize the module.
|
|
|
|
Since 2.56, this function should be named `g_io_<modulename>_unload`, where
|
|
`modulename` is the plugin’s filename with the `lib` or `libgio` prefix and
|
|
everything after the first dot removed, and with `-` replaced with `_`
|
|
throughout. For example, `libgiognutls-helper.so` becomes `gnutls_helper`.
|
|
Using the new symbol names avoids name clashes when building modules
|
|
statically. The old symbol names continue to be supported, but cannot be used
|
|
for static builds.</doc>
|
|
<source-position filename="giomodule.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="module" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giomodule.h" line="129">a #GIOModule.</doc>
|
|
<type name="IOModule" c:type="GIOModule*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<record name="IOModuleClass" c:type="GIOModuleClass" disguised="1" glib:is-gtype-struct-for="IOModule">
|
|
<source-position filename="giomodule.h" line="55"/>
|
|
</record>
|
|
<record name="IOModuleScope" c:type="GIOModuleScope" disguised="1" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1845">Represents a scope for loading IO modules. A scope can be used for blocking
|
|
duplicate modules, or blocking a module you don't want to load.
|
|
|
|
The scope can be used with g_io_modules_load_all_in_directory_with_scope()
|
|
or g_io_modules_scan_all_in_directory_with_scope().</doc>
|
|
<source-position filename="giomodule.h" line="33"/>
|
|
<method name="block" c:identifier="g_io_module_scope_block" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26498">Block modules with the given @basename from being loaded when
|
|
this scope is used with g_io_modules_scan_all_in_directory_with_scope()
|
|
or g_io_modules_load_all_in_directory_with_scope().</doc>
|
|
<source-position filename="giomodule.h" line="40"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="scope" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26500">a module loading scope</doc>
|
|
<type name="IOModuleScope" c:type="GIOModuleScope*"/>
|
|
</instance-parameter>
|
|
<parameter name="basename" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26501">the basename to block</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="g_io_module_scope_free" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26511">Free a module scope.</doc>
|
|
<source-position filename="giomodule.h" line="38"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="scope" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26513">a module loading scope</doc>
|
|
<type name="IOModuleScope" c:type="GIOModuleScope*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="new" c:identifier="g_io_module_scope_new" version="2.30" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26521">Create a new scope for loading of IO modules. A scope can be used for
|
|
blocking duplicate modules, or blocking a module you don't want to load.
|
|
|
|
Specify the %G_IO_MODULE_SCOPE_BLOCK_DUPLICATES flag to block modules
|
|
which have the same base name as a module that has already been seen
|
|
in this scope.</doc>
|
|
<source-position filename="giomodule.h" line="36"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26532">the new module scope</doc>
|
|
<type name="IOModuleScope" c:type="GIOModuleScope*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26523">flags for the new scope</doc>
|
|
<type name="IOModuleScopeFlags" c:type="GIOModuleScopeFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<enumeration name="IOModuleScopeFlags" version="2.30" glib:type-name="GIOModuleScopeFlags" glib:get-type="g_io_module_scope_flags_get_type" c:type="GIOModuleScopeFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1754">Flags for use with g_io_module_scope_new().</doc>
|
|
<member name="none" value="0" c:identifier="G_IO_MODULE_SCOPE_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1756">No module scan flags</doc>
|
|
</member>
|
|
<member name="block_duplicates" value="1" c:identifier="G_IO_MODULE_SCOPE_BLOCK_DUPLICATES" glib:nick="block-duplicates">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1757">When using this scope to load or
|
|
scan modules, automatically block a modules which has the same base
|
|
basename as previously loaded module.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="IOSchedulerJob" c:type="GIOSchedulerJob" disguised="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="114">Opaque class for defining and scheduling IO jobs.</doc>
|
|
<source-position filename="giotypes.h" line="119"/>
|
|
<method name="send_to_mainloop" c:identifier="g_io_scheduler_job_send_to_mainloop" deprecated="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26636">Used from an I/O job to send a callback to be run in the thread
|
|
that the job was started from, waiting for the result (and thus
|
|
blocking the I/O job).</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_main_context_invoke().</doc-deprecated>
|
|
<source-position filename="gioscheduler.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26647">The return value of @func</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="job" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26638">a #GIOSchedulerJob</doc>
|
|
<type name="IOSchedulerJob" c:type="GIOSchedulerJob*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="notified" closure="1" destroy="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26639">a #GSourceFunc callback that will be called in the original thread</doc>
|
|
<type name="GLib.SourceFunc" c:type="GSourceFunc"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26640">data to pass to @func</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="notify" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26641">a #GDestroyNotify for @user_data, or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_to_mainloop_async" c:identifier="g_io_scheduler_job_send_to_mainloop_async" deprecated="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26652">Used from an I/O job to send a callback to be run asynchronously in
|
|
the thread that the job was started from. The callback will be run
|
|
when the main loop is available, but at that time the I/O job might
|
|
have finished. The return value from the callback is ignored.
|
|
|
|
Note that if you are passing the @user_data from g_io_scheduler_push_job()
|
|
on to this function you have to ensure that it is not freed before
|
|
@func is called, either by passing %NULL as @notify to
|
|
g_io_scheduler_push_job() or by using refcounting for @user_data.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_main_context_invoke().</doc-deprecated>
|
|
<source-position filename="gioscheduler.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="job" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26654">a #GIOSchedulerJob</doc>
|
|
<type name="IOSchedulerJob" c:type="GIOSchedulerJob*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none" scope="notified" closure="1" destroy="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26655">a #GSourceFunc callback that will be called in the original thread</doc>
|
|
<type name="GLib.SourceFunc" c:type="GSourceFunc"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26656">data to pass to @func</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="notify" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26657">a #GDestroyNotify for @user_data, or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<callback name="IOSchedulerJobFunc" c:type="GIOSchedulerJobFunc">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="354">I/O Job function.
|
|
|
|
Long-running jobs should periodically check the @cancellable
|
|
to see if they have been cancelled.</doc>
|
|
<source-position filename="giotypes.h" line="368"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="365">%TRUE if this function should be called again to
|
|
complete the job, %FALSE if the job is complete (or cancelled)</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="job" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="356">a #GIOSchedulerJob.</doc>
|
|
<type name="IOSchedulerJob" c:type="GIOSchedulerJob*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="357">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="358">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="IOStream" c:symbol-prefix="io_stream" c:type="GIOStream" version="2.22" parent="GObject.Object" abstract="1" glib:type-name="GIOStream" glib:get-type="g_io_stream_get_type" glib:type-struct="IOStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6717">GIOStream represents an object that has both read and write streams.
|
|
Generally the two streams act as separate input and output streams,
|
|
but they share some common resources and state. For instance, for
|
|
seekable streams, both streams may use the same position.
|
|
|
|
Examples of #GIOStream objects are #GSocketConnection, which represents
|
|
a two-way network connection; and #GFileIOStream, which represents a
|
|
file handle opened in read-write mode.
|
|
|
|
To do the actual reading and writing you need to get the substreams
|
|
with g_io_stream_get_input_stream() and g_io_stream_get_output_stream().
|
|
|
|
The #GIOStream object owns the input and the output streams, not the other
|
|
way around, so keeping the substreams alive will not keep the #GIOStream
|
|
object alive. If the #GIOStream object is freed it will be closed, thus
|
|
closing the substreams, so even if the substreams stay alive they will
|
|
always return %G_IO_ERROR_CLOSED for all operations.
|
|
|
|
To close a stream use g_io_stream_close() which will close the common
|
|
stream object and also the individual substreams. You can also close
|
|
the substreams themselves. In most cases this only marks the
|
|
substream as closed, so further I/O on it fails but common state in the
|
|
#GIOStream may still be open. However, some streams may support
|
|
"half-closed" states where one direction of the stream is actually shut down.
|
|
|
|
Operations on #GIOStreams cannot be started while another operation on the
|
|
#GIOStream or its substreams is in progress. Specifically, an application can
|
|
read from the #GInputStream and write to the #GOutputStream simultaneously
|
|
(either in separate threads, or as asynchronous operations in the same
|
|
thread), but an application cannot start any #GIOStream operation while there
|
|
is a #GIOStream, #GInputStream or #GOutputStream operation in progress, and
|
|
an application can’t start any #GInputStream or #GOutputStream operation
|
|
while there is a #GIOStream operation in progress.
|
|
|
|
This is a product of individual stream operations being associated with a
|
|
given #GMainContext (the thread-default context at the time the operation was
|
|
started), rather than entire streams being associated with a single
|
|
#GMainContext.
|
|
|
|
GIO may run operations on #GIOStreams from other (worker) threads, and this
|
|
may be exposed to application code in the behaviour of wrapper streams, such
|
|
as #GBufferedInputStream or #GTlsConnection. With such wrapper APIs,
|
|
application code may only run operations on the base (wrapped) stream when
|
|
the wrapper stream is idle. Note that the semantics of such operations may
|
|
not be well-defined due to the state the wrapper stream leaves the base
|
|
stream in (though they are guaranteed not to crash).</doc>
|
|
<source-position filename="giostream.h" line="84"/>
|
|
<function name="splice_finish" c:identifier="g_io_stream_splice_finish" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26872">Finishes an asynchronous io stream splice operation.</doc>
|
|
<source-position filename="giostream.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26880">%TRUE on success, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26874">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="close_async" invoker="close_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26750">Requests an asynchronous close of the stream, releasing resources
|
|
related to it. When the operation is finished @callback will be
|
|
called. You can then call g_io_stream_close_finish() to get
|
|
the result of the operation.
|
|
|
|
For behaviour details see g_io_stream_close().
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.</doc>
|
|
<source-position filename="giostream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26752">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26753">the io priority of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26754">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26755">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26756">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_finish" invoker="close_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26773">Closes a stream.</doc>
|
|
<source-position filename="giostream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26782">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26775">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26776">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_fn" throws="1">
|
|
<source-position filename="giostream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_input_stream" invoker="get_input_stream" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26787">Gets the input stream for this object. This is used
|
|
for reading.</doc>
|
|
<source-position filename="giostream.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26794">a #GInputStream, owned by the #GIOStream.
|
|
Do not free.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26789">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_output_stream" invoker="get_output_stream" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26800">Gets the output stream for this object. This is used for
|
|
writing.</doc>
|
|
<source-position filename="giostream.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26807">a #GOutputStream, owned by the #GIOStream.
|
|
Do not free.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26802">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="clear_pending" c:identifier="g_io_stream_clear_pending" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26695">Clears the pending flag on @stream.</doc>
|
|
<source-position filename="giostream.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26697">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close" c:identifier="g_io_stream_close" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26705">Closes the stream, releasing resources related to it. This will also
|
|
close the individual input and output streams, if they are not already
|
|
closed.
|
|
|
|
Once the stream is closed, all other operations will return
|
|
%G_IO_ERROR_CLOSED. Closing a stream multiple times will not
|
|
return an error.
|
|
|
|
Closing a stream will automatically flush any outstanding buffers
|
|
in the stream.
|
|
|
|
Streams will be automatically closed when the last reference
|
|
is dropped, but you might want to call this function to make sure
|
|
resources are released as early as possible.
|
|
|
|
Some streams might keep the backing store of the stream (e.g. a file
|
|
descriptor) open after the stream is closed. See the documentation for
|
|
the individual stream for details.
|
|
|
|
On failure the first error that happened will be reported, but the
|
|
close operation will finish as much as possible. A stream that failed
|
|
to close will still return %G_IO_ERROR_CLOSED for all operations.
|
|
Still, it is important to check and report the error to the user,
|
|
otherwise there might be a loss of data as all data might not be written.
|
|
|
|
If @cancellable is not NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
Cancelling a close will still leave the stream closed, but some streams
|
|
can use a faster close that doesn't block to e.g. check errors.
|
|
|
|
The default implementation of this method just calls close on the
|
|
individual input/output streams.</doc>
|
|
<source-position filename="giostream.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26745">%TRUE on success, %FALSE on failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26707">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26708">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_async" c:identifier="g_io_stream_close_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26750">Requests an asynchronous close of the stream, releasing resources
|
|
related to it. When the operation is finished @callback will be
|
|
called. You can then call g_io_stream_close_finish() to get
|
|
the result of the operation.
|
|
|
|
For behaviour details see g_io_stream_close().
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.</doc>
|
|
<source-position filename="giostream.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26752">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26753">the io priority of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26754">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26755">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26756">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_finish" c:identifier="g_io_stream_close_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26773">Closes a stream.</doc>
|
|
<source-position filename="giostream.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26782">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26775">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26776">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_input_stream" c:identifier="g_io_stream_get_input_stream" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26787">Gets the input stream for this object. This is used
|
|
for reading.</doc>
|
|
<source-position filename="giostream.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26794">a #GInputStream, owned by the #GIOStream.
|
|
Do not free.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26789">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_output_stream" c:identifier="g_io_stream_get_output_stream" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26800">Gets the output stream for this object. This is used for
|
|
writing.</doc>
|
|
<source-position filename="giostream.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26807">a #GOutputStream, owned by the #GIOStream.
|
|
Do not free.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26802">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_pending" c:identifier="g_io_stream_has_pending" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26813">Checks if a stream has pending actions.</doc>
|
|
<source-position filename="giostream.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26819">%TRUE if @stream has pending actions.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26815">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_closed" c:identifier="g_io_stream_is_closed" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26824">Checks if a stream is closed.</doc>
|
|
<source-position filename="giostream.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26830">%TRUE if the stream is closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26826">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pending" c:identifier="g_io_stream_set_pending" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26835">Sets @stream to have actions pending. If the pending flag is
|
|
already set or @stream is closed, it will return %FALSE and set
|
|
@error.</doc>
|
|
<source-position filename="giostream.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26845">%TRUE if pending was previously unset and is now set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26837">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="splice_async" c:identifier="g_io_stream_splice_async" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26850">Asyncronously splice the output stream of @stream1 to the input stream of
|
|
@stream2, and splice the output stream of @stream2 to the input stream of
|
|
@stream1.
|
|
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_io_stream_splice_finish() to get the
|
|
result of the operation.</doc>
|
|
<source-position filename="giostream.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26852">a #GIOStream.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="stream2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26853">a #GIOStream.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26854">a set of #GIOStreamSpliceFlags.</doc>
|
|
<type name="IOStreamSpliceFlags" c:type="GIOStreamSpliceFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26855">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26856">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26857">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26858">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="closed" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="input-stream" transfer-ownership="none">
|
|
<type name="InputStream"/>
|
|
</property>
|
|
<property name="output-stream" transfer-ownership="none">
|
|
<type name="OutputStream"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="IOStreamPrivate" c:type="GIOStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="IOStreamAdapter" c:type="GIOStreamAdapter" disguised="1">
|
|
<source-position filename="giotypes.h" line="120"/>
|
|
</record>
|
|
<record name="IOStreamClass" c:type="GIOStreamClass" glib:is-gtype-struct-for="IOStream">
|
|
<source-position filename="giostream.h" line="84"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_input_stream">
|
|
<callback name="get_input_stream">
|
|
<source-position filename="giostream.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26794">a #GInputStream, owned by the #GIOStream.
|
|
Do not free.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26789">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_output_stream">
|
|
<callback name="get_output_stream">
|
|
<source-position filename="giostream.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26807">a #GOutputStream, owned by the #GIOStream.
|
|
Do not free.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26802">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_fn">
|
|
<callback name="close_fn" throws="1">
|
|
<source-position filename="giostream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_async">
|
|
<callback name="close_async">
|
|
<source-position filename="giostream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26752">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26753">the io priority of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26754">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26755">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26756">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_finish">
|
|
<callback name="close_finish" throws="1">
|
|
<source-position filename="giostream.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26782">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26775">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26776">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="giostream.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="giostream.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="giostream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="giostream.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="giostream.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="giostream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved7" introspectable="0">
|
|
<callback name="_g_reserved7">
|
|
<source-position filename="giostream.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved8" introspectable="0">
|
|
<callback name="_g_reserved8">
|
|
<source-position filename="giostream.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved9" introspectable="0">
|
|
<callback name="_g_reserved9">
|
|
<source-position filename="giostream.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved10" introspectable="0">
|
|
<callback name="_g_reserved10">
|
|
<source-position filename="giostream.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="IOStreamPrivate" c:type="GIOStreamPrivate" disguised="1">
|
|
<source-position filename="giostream.h" line="38"/>
|
|
</record>
|
|
<bitfield name="IOStreamSpliceFlags" version="2.28" glib:type-name="GIOStreamSpliceFlags" glib:get-type="g_io_stream_splice_flags_get_type" c:type="GIOStreamSpliceFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="657">GIOStreamSpliceFlags determine how streams should be spliced.</doc>
|
|
<member name="none" value="0" c:identifier="G_IO_STREAM_SPLICE_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="659">Do not close either stream.</doc>
|
|
</member>
|
|
<member name="close_stream1" value="1" c:identifier="G_IO_STREAM_SPLICE_CLOSE_STREAM1" glib:nick="close-stream1">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="660">Close the first stream after
|
|
the splice.</doc>
|
|
</member>
|
|
<member name="close_stream2" value="2" c:identifier="G_IO_STREAM_SPLICE_CLOSE_STREAM2" glib:nick="close-stream2">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="662">Close the second stream after
|
|
the splice.</doc>
|
|
</member>
|
|
<member name="wait_for_both" value="4" c:identifier="G_IO_STREAM_SPLICE_WAIT_FOR_BOTH" glib:nick="wait-for-both">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="664">Wait for both splice operations to finish
|
|
before calling the callback.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<function-macro name="IO_IS_MODULE" c:identifier="G_IO_IS_MODULE" introspectable="0">
|
|
<source-position filename="giomodule.h" line="46"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IO_IS_MODULE_CLASS" c:identifier="G_IO_IS_MODULE_CLASS" introspectable="0">
|
|
<source-position filename="giomodule.h" line="47"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IO_MODULE" c:identifier="G_IO_MODULE" introspectable="0">
|
|
<source-position filename="giomodule.h" line="44"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IO_MODULE_CLASS" c:identifier="G_IO_MODULE_CLASS" introspectable="0">
|
|
<source-position filename="giomodule.h" line="45"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IO_MODULE_GET_CLASS" c:identifier="G_IO_MODULE_GET_CLASS" introspectable="0">
|
|
<source-position filename="giomodule.h" line="48"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IO_STREAM" c:identifier="G_IO_STREAM" introspectable="0">
|
|
<source-position filename="giostream.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IO_STREAM_CLASS" c:identifier="G_IO_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="giostream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IO_STREAM_GET_CLASS" c:identifier="G_IO_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="giostream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ACTION" c:identifier="G_IS_ACTION" introspectable="0">
|
|
<source-position filename="gaction.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ACTION_GROUP" c:identifier="G_IS_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gactiongroup.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ACTION_MAP" c:identifier="G_IS_ACTION_MAP" introspectable="0">
|
|
<source-position filename="gactionmap.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APPLICATION" c:identifier="G_IS_APPLICATION" introspectable="0">
|
|
<source-position filename="gapplication.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APPLICATION_CLASS" c:identifier="G_IS_APPLICATION_CLASS" introspectable="0">
|
|
<source-position filename="gapplication.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APPLICATION_COMMAND_LINE" c:identifier="G_IS_APPLICATION_COMMAND_LINE" introspectable="0">
|
|
<source-position filename="gapplicationcommandline.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APPLICATION_COMMAND_LINE_CLASS" c:identifier="G_IS_APPLICATION_COMMAND_LINE_CLASS" introspectable="0">
|
|
<source-position filename="gapplicationcommandline.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APP_INFO" c:identifier="G_IS_APP_INFO" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APP_INFO_MONITOR" c:identifier="G_IS_APP_INFO_MONITOR" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="334"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APP_LAUNCH_CONTEXT" c:identifier="G_IS_APP_LAUNCH_CONTEXT" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_APP_LAUNCH_CONTEXT_CLASS" c:identifier="G_IS_APP_LAUNCH_CONTEXT_CLASS" introspectable="0">
|
|
<source-position filename="gappinfo.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ASYNC_INITABLE" c:identifier="G_IS_ASYNC_INITABLE" introspectable="0">
|
|
<source-position filename="gasyncinitable.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ASYNC_RESULT" c:identifier="G_IS_ASYNC_RESULT" introspectable="0">
|
|
<source-position filename="gasyncresult.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BUFFERED_INPUT_STREAM" c:identifier="G_IS_BUFFERED_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gbufferedinputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BUFFERED_INPUT_STREAM_CLASS" c:identifier="G_IS_BUFFERED_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gbufferedinputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BUFFERED_OUTPUT_STREAM" c:identifier="G_IS_BUFFERED_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gbufferedoutputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BUFFERED_OUTPUT_STREAM_CLASS" c:identifier="G_IS_BUFFERED_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gbufferedoutputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_BYTES_ICON" c:identifier="G_IS_BYTES_ICON" introspectable="0">
|
|
<source-position filename="gbytesicon.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CANCELLABLE" c:identifier="G_IS_CANCELLABLE" introspectable="0">
|
|
<source-position filename="gcancellable.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CANCELLABLE_CLASS" c:identifier="G_IS_CANCELLABLE_CLASS" introspectable="0">
|
|
<source-position filename="gcancellable.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CHARSET_CONVERTER" c:identifier="G_IS_CHARSET_CONVERTER" introspectable="0">
|
|
<source-position filename="gcharsetconverter.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CHARSET_CONVERTER_CLASS" c:identifier="G_IS_CHARSET_CONVERTER_CLASS" introspectable="0">
|
|
<source-position filename="gcharsetconverter.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CONVERTER" c:identifier="G_IS_CONVERTER" introspectable="0">
|
|
<source-position filename="gconverter.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CONVERTER_INPUT_STREAM" c:identifier="G_IS_CONVERTER_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gconverterinputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CONVERTER_INPUT_STREAM_CLASS" c:identifier="G_IS_CONVERTER_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gconverterinputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CONVERTER_OUTPUT_STREAM" c:identifier="G_IS_CONVERTER_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gconverteroutputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CONVERTER_OUTPUT_STREAM_CLASS" c:identifier="G_IS_CONVERTER_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gconverteroutputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CREDENTIALS" c:identifier="G_IS_CREDENTIALS" introspectable="0">
|
|
<source-position filename="gcredentials.h" line="42"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_CREDENTIALS_CLASS" c:identifier="G_IS_CREDENTIALS_CLASS" introspectable="0">
|
|
<source-position filename="gcredentials.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DATAGRAM_BASED" c:identifier="G_IS_DATAGRAM_BASED" introspectable="0">
|
|
<source-position filename="gdatagrambased.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DATA_INPUT_STREAM" c:identifier="G_IS_DATA_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gdatainputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DATA_INPUT_STREAM_CLASS" c:identifier="G_IS_DATA_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gdatainputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DATA_OUTPUT_STREAM" c:identifier="G_IS_DATA_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gdataoutputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DATA_OUTPUT_STREAM_CLASS" c:identifier="G_IS_DATA_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gdataoutputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_ACTION_GROUP" c:identifier="G_IS_DBUS_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gdbusactiongroup.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_ACTION_GROUP_CLASS" c:identifier="G_IS_DBUS_ACTION_GROUP_CLASS" introspectable="0">
|
|
<source-position filename="gdbusactiongroup.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_AUTH_OBSERVER" c:identifier="G_IS_DBUS_AUTH_OBSERVER" introspectable="0">
|
|
<source-position filename="gdbusauthobserver.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_CONNECTION" c:identifier="G_IS_DBUS_CONNECTION" introspectable="0">
|
|
<source-position filename="gdbusconnection.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_INTERFACE" c:identifier="G_IS_DBUS_INTERFACE" introspectable="0">
|
|
<source-position filename="gdbusinterface.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_INTERFACE_SKELETON" c:identifier="G_IS_DBUS_INTERFACE_SKELETON" introspectable="0">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_INTERFACE_SKELETON_CLASS" c:identifier="G_IS_DBUS_INTERFACE_SKELETON_CLASS" introspectable="0">
|
|
<source-position filename="gdbusinterfaceskeleton.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_MENU_MODEL" c:identifier="G_IS_DBUS_MENU_MODEL" introspectable="0">
|
|
<source-position filename="gdbusmenumodel.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_MESSAGE" c:identifier="G_IS_DBUS_MESSAGE" introspectable="0">
|
|
<source-position filename="gdbusmessage.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_METHOD_INVOCATION" c:identifier="G_IS_DBUS_METHOD_INVOCATION" introspectable="0">
|
|
<source-position filename="gdbusmethodinvocation.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT" c:identifier="G_IS_DBUS_OBJECT" introspectable="0">
|
|
<source-position filename="gdbusobject.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_MANAGER" c:identifier="G_IS_DBUS_OBJECT_MANAGER" introspectable="0">
|
|
<source-position filename="gdbusobjectmanager.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_MANAGER_CLIENT" c:identifier="G_IS_DBUS_OBJECT_MANAGER_CLIENT" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_MANAGER_CLIENT_CLASS" c:identifier="G_IS_DBUS_OBJECT_MANAGER_CLIENT_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerclient.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_MANAGER_SERVER" c:identifier="G_IS_DBUS_OBJECT_MANAGER_SERVER" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_MANAGER_SERVER_CLASS" c:identifier="G_IS_DBUS_OBJECT_MANAGER_SERVER_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectmanagerserver.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_PROXY" c:identifier="G_IS_DBUS_OBJECT_PROXY" introspectable="0">
|
|
<source-position filename="gdbusobjectproxy.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_PROXY_CLASS" c:identifier="G_IS_DBUS_OBJECT_PROXY_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectproxy.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_SKELETON" c:identifier="G_IS_DBUS_OBJECT_SKELETON" introspectable="0">
|
|
<source-position filename="gdbusobjectskeleton.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_OBJECT_SKELETON_CLASS" c:identifier="G_IS_DBUS_OBJECT_SKELETON_CLASS" introspectable="0">
|
|
<source-position filename="gdbusobjectskeleton.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_PROXY" c:identifier="G_IS_DBUS_PROXY" introspectable="0">
|
|
<source-position filename="gdbusproxy.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_PROXY_CLASS" c:identifier="G_IS_DBUS_PROXY_CLASS" introspectable="0">
|
|
<source-position filename="gdbusproxy.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DBUS_SERVER" c:identifier="G_IS_DBUS_SERVER" introspectable="0">
|
|
<source-position filename="gdbusserver.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DESKTOP_APP_INFO" c:identifier="G_IS_DESKTOP_APP_INFO" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DESKTOP_APP_INFO_CLASS" c:identifier="G_IS_DESKTOP_APP_INFO_CLASS" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DESKTOP_APP_INFO_LOOKUP" c:identifier="G_IS_DESKTOP_APP_INFO_LOOKUP" introspectable="0">
|
|
<source-position filename="gdesktopappinfo.h" line="111"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DRIVE" c:identifier="G_IS_DRIVE" introspectable="0">
|
|
<source-position filename="gdrive.h" line="44"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DTLS_CLIENT_CONNECTION" c:identifier="G_IS_DTLS_CLIENT_CONNECTION" introspectable="0">
|
|
<source-position filename="gdtlsclientconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DTLS_CONNECTION" c:identifier="G_IS_DTLS_CONNECTION" introspectable="0">
|
|
<source-position filename="gdtlsconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_DTLS_SERVER_CONNECTION" c:identifier="G_IS_DTLS_SERVER_CONNECTION" introspectable="0">
|
|
<source-position filename="gdtlsserverconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_EMBLEM" c:identifier="G_IS_EMBLEM" introspectable="0">
|
|
<source-position filename="gemblem.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_EMBLEMED_ICON" c:identifier="G_IS_EMBLEMED_ICON" introspectable="0">
|
|
<source-position filename="gemblemedicon.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_EMBLEMED_ICON_CLASS" c:identifier="G_IS_EMBLEMED_ICON_CLASS" introspectable="0">
|
|
<source-position filename="gemblemedicon.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_EMBLEM_CLASS" c:identifier="G_IS_EMBLEM_CLASS" introspectable="0">
|
|
<source-position filename="gemblem.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE" c:identifier="G_IS_FILE" introspectable="0">
|
|
<source-position filename="gfile.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILENAME_COMPLETER" c:identifier="G_IS_FILENAME_COMPLETER" introspectable="0">
|
|
<source-position filename="gfilenamecompleter.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILENAME_COMPLETER_CLASS" c:identifier="G_IS_FILENAME_COMPLETER_CLASS" introspectable="0">
|
|
<source-position filename="gfilenamecompleter.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_DESCRIPTOR_BASED" c:identifier="G_IS_FILE_DESCRIPTOR_BASED" introspectable="0">
|
|
<source-position filename="gfiledescriptorbased.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_ENUMERATOR" c:identifier="G_IS_FILE_ENUMERATOR" introspectable="0">
|
|
<source-position filename="gfileenumerator.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_ENUMERATOR_CLASS" c:identifier="G_IS_FILE_ENUMERATOR_CLASS" introspectable="0">
|
|
<source-position filename="gfileenumerator.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_ICON" c:identifier="G_IS_FILE_ICON" introspectable="0">
|
|
<source-position filename="gfileicon.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_ICON_CLASS" c:identifier="G_IS_FILE_ICON_CLASS" introspectable="0">
|
|
<source-position filename="gfileicon.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_INFO" c:identifier="G_IS_FILE_INFO" introspectable="0">
|
|
<source-position filename="gfileinfo.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_INFO_CLASS" c:identifier="G_IS_FILE_INFO_CLASS" introspectable="0">
|
|
<source-position filename="gfileinfo.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_INPUT_STREAM" c:identifier="G_IS_FILE_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfileinputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_INPUT_STREAM_CLASS" c:identifier="G_IS_FILE_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfileinputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_IO_STREAM" c:identifier="G_IS_FILE_IO_STREAM" introspectable="0">
|
|
<source-position filename="gfileiostream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_IO_STREAM_CLASS" c:identifier="G_IS_FILE_IO_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfileiostream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_MONITOR" c:identifier="G_IS_FILE_MONITOR" introspectable="0">
|
|
<source-position filename="gfilemonitor.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_MONITOR_CLASS" c:identifier="G_IS_FILE_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gfilemonitor.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_OUTPUT_STREAM" c:identifier="G_IS_FILE_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfileoutputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILE_OUTPUT_STREAM_CLASS" c:identifier="G_IS_FILE_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfileoutputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILTER_INPUT_STREAM" c:identifier="G_IS_FILTER_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfilterinputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILTER_INPUT_STREAM_CLASS" c:identifier="G_IS_FILTER_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfilterinputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILTER_OUTPUT_STREAM" c:identifier="G_IS_FILTER_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gfilteroutputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_FILTER_OUTPUT_STREAM_CLASS" c:identifier="G_IS_FILTER_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gfilteroutputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ICON" c:identifier="G_IS_ICON" introspectable="0">
|
|
<source-position filename="gicon.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INET_ADDRESS" c:identifier="G_IS_INET_ADDRESS" introspectable="0">
|
|
<source-position filename="ginetaddress.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INET_ADDRESS_CLASS" c:identifier="G_IS_INET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="ginetaddress.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INET_ADDRESS_MASK" c:identifier="G_IS_INET_ADDRESS_MASK" introspectable="0">
|
|
<source-position filename="ginetaddressmask.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INET_ADDRESS_MASK_CLASS" c:identifier="G_IS_INET_ADDRESS_MASK_CLASS" introspectable="0">
|
|
<source-position filename="ginetaddressmask.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INET_SOCKET_ADDRESS" c:identifier="G_IS_INET_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="ginetsocketaddress.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INET_SOCKET_ADDRESS_CLASS" c:identifier="G_IS_INET_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="ginetsocketaddress.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INITABLE" c:identifier="G_IS_INITABLE" introspectable="0">
|
|
<source-position filename="ginitable.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INPUT_STREAM" c:identifier="G_IS_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="ginputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_INPUT_STREAM_CLASS" c:identifier="G_IS_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="ginputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_IO_STREAM" c:identifier="G_IS_IO_STREAM" introspectable="0">
|
|
<source-position filename="giostream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_IO_STREAM_CLASS" c:identifier="G_IS_IO_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="giostream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_LOADABLE_ICON" c:identifier="G_IS_LOADABLE_ICON" introspectable="0">
|
|
<source-position filename="gloadableicon.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MEMORY_INPUT_STREAM" c:identifier="G_IS_MEMORY_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gmemoryinputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MEMORY_INPUT_STREAM_CLASS" c:identifier="G_IS_MEMORY_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gmemoryinputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MEMORY_OUTPUT_STREAM" c:identifier="G_IS_MEMORY_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gmemoryoutputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MEMORY_OUTPUT_STREAM_CLASS" c:identifier="G_IS_MEMORY_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gmemoryoutputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU" c:identifier="G_IS_MENU" introspectable="0">
|
|
<source-position filename="gmenu.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU_ATTRIBUTE_ITER" c:identifier="G_IS_MENU_ATTRIBUTE_ITER" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="225"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU_ATTRIBUTE_ITER_CLASS" c:identifier="G_IS_MENU_ATTRIBUTE_ITER_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="227"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU_ITEM" c:identifier="G_IS_MENU_ITEM" introspectable="0">
|
|
<source-position filename="gmenu.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU_LINK_ITER" c:identifier="G_IS_MENU_LINK_ITER" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="267"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU_LINK_ITER_CLASS" c:identifier="G_IS_MENU_LINK_ITER_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="269"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU_MODEL" c:identifier="G_IS_MENU_MODEL" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="118"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MENU_MODEL_CLASS" c:identifier="G_IS_MENU_MODEL_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="120"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MOUNT" c:identifier="G_IS_MOUNT" introspectable="0">
|
|
<source-position filename="gmount.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MOUNT_OPERATION" c:identifier="G_IS_MOUNT_OPERATION" introspectable="0">
|
|
<source-position filename="gmountoperation.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_MOUNT_OPERATION_CLASS" c:identifier="G_IS_MOUNT_OPERATION_CLASS" introspectable="0">
|
|
<source-position filename="gmountoperation.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NATIVE_SOCKET_ADDRESS" c:identifier="G_IS_NATIVE_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="gnativesocketaddress.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NATIVE_SOCKET_ADDRESS_CLASS" c:identifier="G_IS_NATIVE_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gnativesocketaddress.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NATIVE_VOLUME_MONITOR" c:identifier="G_IS_NATIVE_VOLUME_MONITOR" introspectable="0">
|
|
<source-position filename="gnativevolumemonitor.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NATIVE_VOLUME_MONITOR_CLASS" c:identifier="G_IS_NATIVE_VOLUME_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gnativevolumemonitor.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NETWORK_ADDRESS" c:identifier="G_IS_NETWORK_ADDRESS" introspectable="0">
|
|
<source-position filename="gnetworkaddress.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NETWORK_ADDRESS_CLASS" c:identifier="G_IS_NETWORK_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gnetworkaddress.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NETWORK_MONITOR" c:identifier="G_IS_NETWORK_MONITOR" introspectable="0">
|
|
<source-position filename="gnetworkmonitor.h" line="42"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NETWORK_SERVICE" c:identifier="G_IS_NETWORK_SERVICE" introspectable="0">
|
|
<source-position filename="gnetworkservice.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NETWORK_SERVICE_CLASS" c:identifier="G_IS_NETWORK_SERVICE_CLASS" introspectable="0">
|
|
<source-position filename="gnetworkservice.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_NOTIFICATION" c:identifier="G_IS_NOTIFICATION" introspectable="0">
|
|
<source-position filename="gnotification.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_OUTPUT_STREAM" c:identifier="G_IS_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="goutputstream.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_OUTPUT_STREAM_CLASS" c:identifier="G_IS_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="goutputstream.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PERMISSION" c:identifier="G_IS_PERMISSION" introspectable="0">
|
|
<source-position filename="gpermission.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PERMISSION_CLASS" c:identifier="G_IS_PERMISSION_CLASS" introspectable="0">
|
|
<source-position filename="gpermission.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_POLLABLE_INPUT_STREAM" c:identifier="G_IS_POLLABLE_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gpollableinputstream.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_POLLABLE_OUTPUT_STREAM" c:identifier="G_IS_POLLABLE_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gpollableoutputstream.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PROPERTY_ACTION" c:identifier="G_IS_PROPERTY_ACTION" introspectable="0">
|
|
<source-position filename="gpropertyaction.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PROXY" c:identifier="G_IS_PROXY" introspectable="0">
|
|
<source-position filename="gproxy.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PROXY_ADDRESS" c:identifier="G_IS_PROXY_ADDRESS" introspectable="0">
|
|
<source-position filename="gproxyaddress.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PROXY_ADDRESS_CLASS" c:identifier="G_IS_PROXY_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gproxyaddress.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PROXY_ADDRESS_ENUMERATOR" c:identifier="G_IS_PROXY_ADDRESS_ENUMERATOR" introspectable="0">
|
|
<source-position filename="gproxyaddressenumerator.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PROXY_ADDRESS_ENUMERATOR_CLASS" c:identifier="G_IS_PROXY_ADDRESS_ENUMERATOR_CLASS" introspectable="0">
|
|
<source-position filename="gproxyaddressenumerator.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_PROXY_RESOLVER" c:identifier="G_IS_PROXY_RESOLVER" introspectable="0">
|
|
<source-position filename="gproxyresolver.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_REMOTE_ACTION_GROUP" c:identifier="G_IS_REMOTE_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gremoteactiongroup.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_RESOLVER" c:identifier="G_IS_RESOLVER" introspectable="0">
|
|
<source-position filename="gresolver.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_RESOLVER_CLASS" c:identifier="G_IS_RESOLVER_CLASS" introspectable="0">
|
|
<source-position filename="gresolver.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SEEKABLE" c:identifier="G_IS_SEEKABLE" introspectable="0">
|
|
<source-position filename="gseekable.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SETTINGS" c:identifier="G_IS_SETTINGS" introspectable="0">
|
|
<source-position filename="gsettings.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SETTINGS_BACKEND" c:identifier="G_IS_SETTINGS_BACKEND" introspectable="0">
|
|
<source-position filename="gsettingsbackend.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SETTINGS_BACKEND_CLASS" c:identifier="G_IS_SETTINGS_BACKEND_CLASS" introspectable="0">
|
|
<source-position filename="gsettingsbackend.h" line="42"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SETTINGS_CLASS" c:identifier="G_IS_SETTINGS_CLASS" introspectable="0">
|
|
<source-position filename="gsettings.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_ACTION" c:identifier="G_IS_SIMPLE_ACTION" introspectable="0">
|
|
<source-position filename="gsimpleaction.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_ACTION_GROUP" c:identifier="G_IS_SIMPLE_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gsimpleactiongroup.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_ACTION_GROUP_CLASS" c:identifier="G_IS_SIMPLE_ACTION_GROUP_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleactiongroup.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_ASYNC_RESULT" c:identifier="G_IS_SIMPLE_ASYNC_RESULT" introspectable="0">
|
|
<source-position filename="gsimpleasyncresult.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_ASYNC_RESULT_CLASS" c:identifier="G_IS_SIMPLE_ASYNC_RESULT_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleasyncresult.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_IO_STREAM" c:identifier="G_IS_SIMPLE_IO_STREAM" introspectable="0">
|
|
<source-position filename="gsimpleiostream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_PERMISSION" c:identifier="G_IS_SIMPLE_PERMISSION" introspectable="0">
|
|
<source-position filename="gsimplepermission.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_PROXY_RESOLVER" c:identifier="G_IS_SIMPLE_PROXY_RESOLVER" introspectable="0">
|
|
<source-position filename="gsimpleproxyresolver.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SIMPLE_PROXY_RESOLVER_CLASS" c:identifier="G_IS_SIMPLE_PROXY_RESOLVER_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleproxyresolver.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET" c:identifier="G_IS_SOCKET" introspectable="0">
|
|
<source-position filename="gsocket.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_ADDRESS" c:identifier="G_IS_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="gsocketaddress.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_ADDRESS_CLASS" c:identifier="G_IS_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gsocketaddress.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_ADDRESS_ENUMERATOR" c:identifier="G_IS_SOCKET_ADDRESS_ENUMERATOR" introspectable="0">
|
|
<source-position filename="gsocketaddressenumerator.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_ADDRESS_ENUMERATOR_CLASS" c:identifier="G_IS_SOCKET_ADDRESS_ENUMERATOR_CLASS" introspectable="0">
|
|
<source-position filename="gsocketaddressenumerator.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CLASS" c:identifier="G_IS_SOCKET_CLASS" introspectable="0">
|
|
<source-position filename="gsocket.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CLIENT" c:identifier="G_IS_SOCKET_CLIENT" introspectable="0">
|
|
<source-position filename="gsocketclient.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CLIENT_CLASS" c:identifier="G_IS_SOCKET_CLIENT_CLASS" introspectable="0">
|
|
<source-position filename="gsocketclient.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CONNECTABLE" c:identifier="G_IS_SOCKET_CONNECTABLE" introspectable="0">
|
|
<source-position filename="gsocketconnectable.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CONNECTION" c:identifier="G_IS_SOCKET_CONNECTION" introspectable="0">
|
|
<source-position filename="gsocketconnection.h" line="42"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CONNECTION_CLASS" c:identifier="G_IS_SOCKET_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gsocketconnection.h" line="44"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CONTROL_MESSAGE" c:identifier="G_IS_SOCKET_CONTROL_MESSAGE" introspectable="0">
|
|
<source-position filename="gsocketcontrolmessage.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_CONTROL_MESSAGE_CLASS" c:identifier="G_IS_SOCKET_CONTROL_MESSAGE_CLASS" introspectable="0">
|
|
<source-position filename="gsocketcontrolmessage.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_LISTENER" c:identifier="G_IS_SOCKET_LISTENER" introspectable="0">
|
|
<source-position filename="gsocketlistener.h" line="42"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_LISTENER_CLASS" c:identifier="G_IS_SOCKET_LISTENER_CLASS" introspectable="0">
|
|
<source-position filename="gsocketlistener.h" line="44"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_SERVICE" c:identifier="G_IS_SOCKET_SERVICE" introspectable="0">
|
|
<source-position filename="gsocketservice.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SOCKET_SERVICE_CLASS" c:identifier="G_IS_SOCKET_SERVICE_CLASS" introspectable="0">
|
|
<source-position filename="gsocketservice.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SUBPROCESS" c:identifier="G_IS_SUBPROCESS" introspectable="0">
|
|
<source-position filename="gsubprocess.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_SUBPROCESS_LAUNCHER" c:identifier="G_IS_SUBPROCESS_LAUNCHER" introspectable="0">
|
|
<source-position filename="gsubprocesslauncher.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TASK" c:identifier="G_IS_TASK" introspectable="0">
|
|
<source-position filename="gtask.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TASK_CLASS" c:identifier="G_IS_TASK_CLASS" introspectable="0">
|
|
<source-position filename="gtask.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TCP_CONNECTION" c:identifier="G_IS_TCP_CONNECTION" introspectable="0">
|
|
<source-position filename="gtcpconnection.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TCP_CONNECTION_CLASS" c:identifier="G_IS_TCP_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gtcpconnection.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TCP_WRAPPER_CONNECTION" c:identifier="G_IS_TCP_WRAPPER_CONNECTION" introspectable="0">
|
|
<source-position filename="gtcpwrapperconnection.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TCP_WRAPPER_CONNECTION_CLASS" c:identifier="G_IS_TCP_WRAPPER_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gtcpwrapperconnection.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TEST_DBUS" c:identifier="G_IS_TEST_DBUS" introspectable="0">
|
|
<source-position filename="gtestdbus.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_THEMED_ICON" c:identifier="G_IS_THEMED_ICON" introspectable="0">
|
|
<source-position filename="gthemedicon.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_THEMED_ICON_CLASS" c:identifier="G_IS_THEMED_ICON_CLASS" introspectable="0">
|
|
<source-position filename="gthemedicon.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_THREADED_SOCKET_SERVICE" c:identifier="G_IS_THREADED_SOCKET_SERVICE" introspectable="0">
|
|
<source-position filename="gthreadedsocketservice.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_THREADED_SOCKET_SERVICE_CLASS" c:identifier="G_IS_THREADED_SOCKET_SERVICE_CLASS" introspectable="0">
|
|
<source-position filename="gthreadedsocketservice.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_BACKEND" c:identifier="G_IS_TLS_BACKEND" introspectable="0">
|
|
<source-position filename="gtlsbackend.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_CERTIFICATE" c:identifier="G_IS_TLS_CERTIFICATE" introspectable="0">
|
|
<source-position filename="gtlscertificate.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_CERTIFICATE_CLASS" c:identifier="G_IS_TLS_CERTIFICATE_CLASS" introspectable="0">
|
|
<source-position filename="gtlscertificate.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_CLIENT_CONNECTION" c:identifier="G_IS_TLS_CLIENT_CONNECTION" introspectable="0">
|
|
<source-position filename="gtlsclientconnection.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_CONNECTION" c:identifier="G_IS_TLS_CONNECTION" introspectable="0">
|
|
<source-position filename="gtlsconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_CONNECTION_CLASS" c:identifier="G_IS_TLS_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gtlsconnection.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_DATABASE" c:identifier="G_IS_TLS_DATABASE" introspectable="0">
|
|
<source-position filename="gtlsdatabase.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_DATABASE_CLASS" c:identifier="G_IS_TLS_DATABASE_CLASS" introspectable="0">
|
|
<source-position filename="gtlsdatabase.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_FILE_DATABASE" c:identifier="G_IS_TLS_FILE_DATABASE" introspectable="0">
|
|
<source-position filename="gtlsfiledatabase.h" line="28"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_INTERACTION" c:identifier="G_IS_TLS_INTERACTION" introspectable="0">
|
|
<source-position filename="gtlsinteraction.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_INTERACTION_CLASS" c:identifier="G_IS_TLS_INTERACTION_CLASS" introspectable="0">
|
|
<source-position filename="gtlsinteraction.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_PASSWORD" c:identifier="G_IS_TLS_PASSWORD" introspectable="0">
|
|
<source-position filename="gtlspassword.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_PASSWORD_CLASS" c:identifier="G_IS_TLS_PASSWORD_CLASS" introspectable="0">
|
|
<source-position filename="gtlspassword.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_TLS_SERVER_CONNECTION" c:identifier="G_IS_TLS_SERVER_CONNECTION" introspectable="0">
|
|
<source-position filename="gtlsserverconnection.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_CONNECTION" c:identifier="G_IS_UNIX_CONNECTION" introspectable="0">
|
|
<source-position filename="gunixconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_CONNECTION_CLASS" c:identifier="G_IS_UNIX_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gunixconnection.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_CREDENTIALS_MESSAGE" c:identifier="G_IS_UNIX_CREDENTIALS_MESSAGE" introspectable="0">
|
|
<source-position filename="gunixcredentialsmessage.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_CREDENTIALS_MESSAGE_CLASS" c:identifier="G_IS_UNIX_CREDENTIALS_MESSAGE_CLASS" introspectable="0">
|
|
<source-position filename="gunixcredentialsmessage.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="c">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_FD_LIST" c:identifier="G_IS_UNIX_FD_LIST" introspectable="0">
|
|
<source-position filename="gunixfdlist.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_FD_LIST_CLASS" c:identifier="G_IS_UNIX_FD_LIST_CLASS" introspectable="0">
|
|
<source-position filename="gunixfdlist.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_FD_MESSAGE" c:identifier="G_IS_UNIX_FD_MESSAGE" introspectable="0">
|
|
<source-position filename="gunixfdmessage.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_FD_MESSAGE_CLASS" c:identifier="G_IS_UNIX_FD_MESSAGE_CLASS" introspectable="0">
|
|
<source-position filename="gunixfdmessage.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_INPUT_STREAM" c:identifier="G_IS_UNIX_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gunixinputstream.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_INPUT_STREAM_CLASS" c:identifier="G_IS_UNIX_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gunixinputstream.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_MOUNT_MONITOR" c:identifier="G_IS_UNIX_MOUNT_MONITOR" introspectable="0">
|
|
<source-position filename="gunixmounts.h" line="63"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_MOUNT_MONITOR_CLASS" c:identifier="G_IS_UNIX_MOUNT_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gunixmounts.h" line="64"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_OUTPUT_STREAM" c:identifier="G_IS_UNIX_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gunixoutputstream.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_OUTPUT_STREAM_CLASS" c:identifier="G_IS_UNIX_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gunixoutputstream.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_SOCKET_ADDRESS" c:identifier="G_IS_UNIX_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="gunixsocketaddress.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_UNIX_SOCKET_ADDRESS_CLASS" c:identifier="G_IS_UNIX_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gunixsocketaddress.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_VFS" c:identifier="G_IS_VFS" introspectable="0">
|
|
<source-position filename="gvfs.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_VFS_CLASS" c:identifier="G_IS_VFS_CLASS" introspectable="0">
|
|
<source-position filename="gvfs.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_VOLUME" c:identifier="G_IS_VOLUME" introspectable="0">
|
|
<source-position filename="gvolume.h" line="88"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_VOLUME_MONITOR" c:identifier="G_IS_VOLUME_MONITOR" introspectable="0">
|
|
<source-position filename="gvolumemonitor.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_VOLUME_MONITOR_CLASS" c:identifier="G_IS_VOLUME_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gvolumemonitor.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ZLIB_COMPRESSOR" c:identifier="G_IS_ZLIB_COMPRESSOR" introspectable="0">
|
|
<source-position filename="gzlibcompressor.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ZLIB_COMPRESSOR_CLASS" c:identifier="G_IS_ZLIB_COMPRESSOR_CLASS" introspectable="0">
|
|
<source-position filename="gzlibcompressor.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ZLIB_DECOMPRESSOR" c:identifier="G_IS_ZLIB_DECOMPRESSOR" introspectable="0">
|
|
<source-position filename="gzlibdecompressor.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="IS_ZLIB_DECOMPRESSOR_CLASS" c:identifier="G_IS_ZLIB_DECOMPRESSOR_CLASS" introspectable="0">
|
|
<source-position filename="gzlibdecompressor.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<interface name="Icon" c:symbol-prefix="icon" c:type="GIcon" glib:type-name="GIcon" glib:get-type="g_icon_get_type" glib:type-struct="IconIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6556">#GIcon is a very minimal interface for icons. It provides functions
|
|
for checking the equality of two icons, hashing of icons and
|
|
serializing an icon to and from strings.
|
|
|
|
#GIcon does not provide the actual pixmap for the icon as this is out
|
|
of GIO's scope, however implementations of #GIcon may contain the name
|
|
of an icon (see #GThemedIcon), or the path to an icon (see #GLoadableIcon).
|
|
|
|
To obtain a hash of a #GIcon, see g_icon_hash().
|
|
|
|
To check if two #GIcons are equal, see g_icon_equal().
|
|
|
|
For serializing a #GIcon, use g_icon_serialize() and
|
|
g_icon_deserialize().
|
|
|
|
If you want to consume #GIcon (for example, in a toolkit) you must
|
|
be prepared to handle at least the three following cases:
|
|
#GLoadableIcon, #GThemedIcon and #GEmblemedIcon. It may also make
|
|
sense to have fast-paths for other cases (like handling #GdkPixbuf
|
|
directly, for example) but all compliant #GIcon implementations
|
|
outside of GIO must implement #GLoadableIcon.
|
|
|
|
If your application or library provides one or more #GIcon
|
|
implementations you need to ensure that your new implementation also
|
|
implements #GLoadableIcon. Additionally, you must provide an
|
|
implementation of g_icon_serialize() that gives a result that is
|
|
understood by g_icon_deserialize(), yielding one of the built-in icon
|
|
types.</doc>
|
|
<source-position filename="gicon.h" line="79"/>
|
|
<function name="deserialize" c:identifier="g_icon_deserialize" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25265">Deserializes a #GIcon previously serialized using g_icon_serialize().</doc>
|
|
<source-position filename="gicon.h" line="98"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25271">a #GIcon, or %NULL when deserialization fails.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25267">a #GVariant created with g_icon_serialize()</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="hash" c:identifier="g_icon_hash">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25287">Gets a hash for an icon.</doc>
|
|
<source-position filename="gicon.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25293">a #guint containing a hash for the @icon, suitable for
|
|
use in a #GHashTable or similar data structure.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25289">#gconstpointer to an icon object.</doc>
|
|
<type name="gpointer" c:type="gconstpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_for_string" c:identifier="g_icon_new_for_string" version="2.20" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25298">Generate a #GIcon instance from @str. This function can fail if
|
|
@str is not valid - see g_icon_to_string() for discussion.
|
|
|
|
If your application or library provides one or more #GIcon
|
|
implementations you need to ensure that each #GType is registered
|
|
with the type system prior to calling g_icon_new_for_string().</doc>
|
|
<source-position filename="gicon.h" line="92"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25310">An object implementing the #GIcon
|
|
interface or %NULL if @error is set.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="str" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25300">A string obtained via g_icon_to_string().</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="equal" invoker="equal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25276">Checks if two icons are equal.</doc>
|
|
<source-position filename="gicon.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25283">%TRUE if @icon1 is equal to @icon2. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon1" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25278">pointer to the first #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="icon2" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25279">pointer to the second #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="hash" invoker="hash">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25287">Gets a hash for an icon.</doc>
|
|
<source-position filename="gicon.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25293">a #guint containing a hash for the @icon, suitable for
|
|
use in a #GHashTable or similar data structure.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25289">#gconstpointer to an icon object.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="serialize" invoker="serialize" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25316">Serializes a #GIcon into a #GVariant. An equivalent #GIcon can be retrieved
|
|
back by calling g_icon_deserialize() on the returned value.
|
|
As serialization will avoid using raw icon data when possible, it only
|
|
makes sense to transfer the #GVariant between processes on the same machine,
|
|
(as opposed to over the network), and within the same file system namespace.</doc>
|
|
<source-position filename="gicon.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25326">a #GVariant, or %NULL when serialization fails.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25318">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="to_tokens" invoker="to_string" version="2.20" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25331">Generates a textual representation of @icon that can be used for
|
|
serialization such as when passing @icon to a different process or
|
|
saving it to persistent storage. Use g_icon_new_for_string() to
|
|
get @icon back from the returned string.
|
|
|
|
The encoding of the returned string is proprietary to #GIcon except
|
|
in the following two cases
|
|
|
|
- If @icon is a #GFileIcon, the returned string is a native path
|
|
(such as `/path/to/my icon.png`) without escaping
|
|
if the #GFile for @icon is a native file. If the file is not
|
|
native, the returned string is the result of g_file_get_uri()
|
|
(such as `sftp://path/to/my%20icon.png`).
|
|
|
|
- If @icon is a #GThemedIcon with exactly one name and no fallbacks,
|
|
the encoding is simply the name (such as `network-server`).</doc>
|
|
<source-position filename="gicon.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25352">An allocated NUL-terminated UTF8 string or
|
|
%NULL if @icon can't be serialized. Use g_free() to free.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25333">a #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="tokens" transfer-ownership="none">
|
|
<array name="GLib.PtrArray" c:type="GPtrArray*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="out_version" transfer-ownership="none">
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="equal" c:identifier="g_icon_equal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25276">Checks if two icons are equal.</doc>
|
|
<source-position filename="gicon.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25283">%TRUE if @icon1 is equal to @icon2. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon1" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25278">pointer to the first #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="icon2" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25279">pointer to the second #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="serialize" c:identifier="g_icon_serialize" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25316">Serializes a #GIcon into a #GVariant. An equivalent #GIcon can be retrieved
|
|
back by calling g_icon_deserialize() on the returned value.
|
|
As serialization will avoid using raw icon data when possible, it only
|
|
makes sense to transfer the #GVariant between processes on the same machine,
|
|
(as opposed to over the network), and within the same file system namespace.</doc>
|
|
<source-position filename="gicon.h" line="96"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25326">a #GVariant, or %NULL when serialization fails.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25318">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_string" c:identifier="g_icon_to_string" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25331">Generates a textual representation of @icon that can be used for
|
|
serialization such as when passing @icon to a different process or
|
|
saving it to persistent storage. Use g_icon_new_for_string() to
|
|
get @icon back from the returned string.
|
|
|
|
The encoding of the returned string is proprietary to #GIcon except
|
|
in the following two cases
|
|
|
|
- If @icon is a #GFileIcon, the returned string is a native path
|
|
(such as `/path/to/my icon.png`) without escaping
|
|
if the #GFile for @icon is a native file. If the file is not
|
|
native, the returned string is the result of g_file_get_uri()
|
|
(such as `sftp://path/to/my%20icon.png`).
|
|
|
|
- If @icon is a #GThemedIcon with exactly one name and no fallbacks,
|
|
the encoding is simply the name (such as `network-server`).</doc>
|
|
<source-position filename="gicon.h" line="90"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25352">An allocated NUL-terminated UTF8 string or
|
|
%NULL if @icon can't be serialized. Use g_free() to free.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25333">a #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="IconIface" c:type="GIconIface" glib:is-gtype-struct-for="Icon">
|
|
<doc xml:space="preserve" filename="gicon.h" line="44">GIconIface is used to implement GIcon types for various
|
|
different systems. See #GThemedIcon and #GLoadableIcon for
|
|
examples of how to implement this interface.</doc>
|
|
<source-position filename="gicon.h" line="79"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gicon.h" line="46">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="hash">
|
|
<callback name="hash">
|
|
<source-position filename="gicon.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25293">a #guint containing a hash for the @icon, suitable for
|
|
use in a #GHashTable or similar data structure.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25289">#gconstpointer to an icon object.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="equal">
|
|
<callback name="equal">
|
|
<source-position filename="gicon.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25283">%TRUE if @icon1 is equal to @icon2. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon1" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25278">pointer to the first #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
<parameter name="icon2" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25279">pointer to the second #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="to_tokens" introspectable="0">
|
|
<callback name="to_tokens" introspectable="0">
|
|
<source-position filename="gicon.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25352">An allocated NUL-terminated UTF8 string or
|
|
%NULL if @icon can't be serialized. Use g_free() to free.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25333">a #GIcon.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
<parameter name="tokens" transfer-ownership="none">
|
|
<array name="GLib.PtrArray" c:type="GPtrArray*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="out_version" transfer-ownership="none">
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="from_tokens" introspectable="0">
|
|
<callback name="from_tokens" introspectable="0" throws="1">
|
|
<source-position filename="gicon.h" line="73"/>
|
|
<return-value>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="tokens" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
<parameter name="num_tokens" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="version" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="serialize">
|
|
<callback name="serialize">
|
|
<source-position filename="gicon.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25326">a #GVariant, or %NULL when serialization fails.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25318">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="InetAddress" c:symbol-prefix="inet_address" c:type="GInetAddress" parent="GObject.Object" glib:type-name="GInetAddress" glib:get-type="g_inet_address_get_type" glib:type-struct="InetAddressClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6592">#GInetAddress represents an IPv4 or IPv6 internet address. Use
|
|
g_resolver_lookup_by_name() or g_resolver_lookup_by_name_async() to
|
|
look up the #GInetAddress for a hostname. Use
|
|
g_resolver_lookup_by_address() or
|
|
g_resolver_lookup_by_address_async() to look up the hostname for a
|
|
#GInetAddress.
|
|
|
|
To actually connect to a remote host, you will need a
|
|
#GInetSocketAddress (which includes a #GInetAddress as well as a
|
|
port number).</doc>
|
|
<source-position filename="ginetaddress.h" line="57"/>
|
|
<constructor name="new_any" c:identifier="g_inet_address_new_any" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25607">Creates a #GInetAddress for the "any" address (unassigned/"don't
|
|
care") for @family.</doc>
|
|
<source-position filename="ginetaddress.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25614">a new #GInetAddress corresponding to the "any" address
|
|
for @family.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="family" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25609">the address family</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_bytes" c:identifier="g_inet_address_new_from_bytes" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25621">Creates a new #GInetAddress from the given @family and @bytes.
|
|
@bytes should be 4 bytes for %G_SOCKET_FAMILY_IPV4 and 16 bytes for
|
|
%G_SOCKET_FAMILY_IPV6.</doc>
|
|
<source-position filename="ginetaddress.h" line="66"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25630">a new #GInetAddress corresponding to @family and @bytes.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25623">raw address data</doc>
|
|
<array zero-terminated="0" c:type="const guint8*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="family" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25624">the address family of @bytes</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_string" c:identifier="g_inet_address_new_from_string" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25636">Parses @string as an IP address and creates a new #GInetAddress.</doc>
|
|
<source-position filename="ginetaddress.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25642">a new #GInetAddress corresponding to @string, or %NULL if
|
|
@string could not be parsed.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25638">a string representation of an IP address</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_loopback" c:identifier="g_inet_address_new_loopback" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25649">Creates a #GInetAddress for the loopback address for @family.</doc>
|
|
<source-position filename="ginetaddress.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25655">a new #GInetAddress corresponding to the loopback address
|
|
for @family.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="family" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25651">the address family</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<virtual-method name="to_bytes" invoker="to_bytes" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25662">Gets the raw binary address data from @address.</doc>
|
|
<source-position filename="ginetaddress.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25668">a pointer to an internal array of the bytes in @address,
|
|
which should not be modified, stored, or freed. The size of this
|
|
array can be gotten with g_inet_address_get_native_size().</doc>
|
|
<type name="guint8" c:type="const guint8*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25664">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="to_string" invoker="to_string" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25675">Converts @address to string form.</doc>
|
|
<source-position filename="ginetaddress.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25681">a representation of @address as a string, which should be
|
|
freed after use.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25677">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="equal" c:identifier="g_inet_address_equal" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25358">Checks if two #GInetAddress instances are equal, e.g. the same address.</doc>
|
|
<source-position filename="ginetaddress.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25365">%TRUE if @address and @other_address are equal, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25360">A #GInetAddress.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
<parameter name="other_address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25361">Another #GInetAddress.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_family" c:identifier="g_inet_address_get_family" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25370">Gets @address's family</doc>
|
|
<source-position filename="ginetaddress.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25376">@address's family</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25372">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_any" c:identifier="g_inet_address_get_is_any" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25381">Tests whether @address is the "any" address for its family.</doc>
|
|
<source-position filename="ginetaddress.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25387">%TRUE if @address is the "any" address for its family.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25383">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_link_local" c:identifier="g_inet_address_get_is_link_local" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25392">Tests whether @address is a link-local address (that is, if it
|
|
identifies a host on a local network that is not connected to the
|
|
Internet).</doc>
|
|
<source-position filename="ginetaddress.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25400">%TRUE if @address is a link-local address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25394">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_loopback" c:identifier="g_inet_address_get_is_loopback" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25405">Tests whether @address is the loopback address for its family.</doc>
|
|
<source-position filename="ginetaddress.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25411">%TRUE if @address is the loopback address for its family.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25407">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_mc_global" c:identifier="g_inet_address_get_is_mc_global" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25416">Tests whether @address is a global multicast address.</doc>
|
|
<source-position filename="ginetaddress.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25422">%TRUE if @address is a global multicast address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25418">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_mc_link_local" c:identifier="g_inet_address_get_is_mc_link_local" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25427">Tests whether @address is a link-local multicast address.</doc>
|
|
<source-position filename="ginetaddress.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25433">%TRUE if @address is a link-local multicast address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25429">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_mc_node_local" c:identifier="g_inet_address_get_is_mc_node_local" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25438">Tests whether @address is a node-local multicast address.</doc>
|
|
<source-position filename="ginetaddress.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25444">%TRUE if @address is a node-local multicast address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25440">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_mc_org_local" c:identifier="g_inet_address_get_is_mc_org_local" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25449">Tests whether @address is an organization-local multicast address.</doc>
|
|
<source-position filename="ginetaddress.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25455">%TRUE if @address is an organization-local multicast address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25451">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_mc_site_local" c:identifier="g_inet_address_get_is_mc_site_local" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25460">Tests whether @address is a site-local multicast address.</doc>
|
|
<source-position filename="ginetaddress.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25466">%TRUE if @address is a site-local multicast address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25462">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_multicast" c:identifier="g_inet_address_get_is_multicast" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25471">Tests whether @address is a multicast address.</doc>
|
|
<source-position filename="ginetaddress.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25477">%TRUE if @address is a multicast address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25473">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_site_local" c:identifier="g_inet_address_get_is_site_local" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25482">Tests whether @address is a site-local address such as 10.0.0.1
|
|
(that is, the address identifies a host on a local network that can
|
|
not be reached directly from the Internet, but which may have
|
|
outgoing Internet connectivity via a NAT or firewall).</doc>
|
|
<source-position filename="ginetaddress.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25491">%TRUE if @address is a site-local address.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25484">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_native_size" c:identifier="g_inet_address_get_native_size" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25496">Gets the size of the native raw binary address for @address. This
|
|
is the size of the data that you get from g_inet_address_to_bytes().</doc>
|
|
<source-position filename="ginetaddress.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25503">the number of bytes used for the native version of @address.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25498">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_bytes" c:identifier="g_inet_address_to_bytes" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25662">Gets the raw binary address data from @address.</doc>
|
|
<source-position filename="ginetaddress.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25668">a pointer to an internal array of the bytes in @address,
|
|
which should not be modified, stored, or freed. The size of this
|
|
array can be gotten with g_inet_address_get_native_size().</doc>
|
|
<type name="guint8" c:type="const guint8*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25664">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_string" c:identifier="g_inet_address_to_string" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25675">Converts @address to string form.</doc>
|
|
<source-position filename="ginetaddress.h" line="80"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25681">a representation of @address as a string, which should be
|
|
freed after use.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25677">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="bytes" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</property>
|
|
<property name="family" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="SocketFamily"/>
|
|
</property>
|
|
<property name="is-any" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1865">Whether this is the "any" address for its family.
|
|
See g_inet_address_get_is_any().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-link-local" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1875">Whether this is a link-local address.
|
|
See g_inet_address_get_is_link_local().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-loopback" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1885">Whether this is the loopback address for its family.
|
|
See g_inet_address_get_is_loopback().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-mc-global" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1895">Whether this is a global multicast address.
|
|
See g_inet_address_get_is_mc_global().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-mc-link-local" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1905">Whether this is a link-local multicast address.
|
|
See g_inet_address_get_is_mc_link_local().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-mc-node-local" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1915">Whether this is a node-local multicast address.
|
|
See g_inet_address_get_is_mc_node_local().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-mc-org-local" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1925">Whether this is an organization-local multicast address.
|
|
See g_inet_address_get_is_mc_org_local().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-mc-site-local" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1935">Whether this is a site-local multicast address.
|
|
See g_inet_address_get_is_mc_site_local().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-multicast" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1945">Whether this is a multicast address.
|
|
See g_inet_address_get_is_multicast().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-site-local" version="2.22" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1955">Whether this is a site-local address.
|
|
See g_inet_address_get_is_loopback().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="InetAddressPrivate" c:type="GInetAddressPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="InetAddressClass" c:type="GInetAddressClass" glib:is-gtype-struct-for="InetAddress">
|
|
<source-position filename="ginetaddress.h" line="57"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="to_string">
|
|
<callback name="to_string">
|
|
<source-position filename="ginetaddress.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25681">a representation of @address as a string, which should be
|
|
freed after use.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25677">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="to_bytes">
|
|
<callback name="to_bytes">
|
|
<source-position filename="ginetaddress.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25668">a pointer to an internal array of the bytes in @address,
|
|
which should not be modified, stored, or freed. The size of this
|
|
array can be gotten with g_inet_address_get_native_size().</doc>
|
|
<type name="guint8" c:type="const guint8*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25664">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="InetAddressMask" c:symbol-prefix="inet_address_mask" c:type="GInetAddressMask" version="2.32" parent="GObject.Object" glib:type-name="GInetAddressMask" glib:get-type="g_inet_address_mask_get_type" glib:type-struct="InetAddressMaskClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6610">#GInetAddressMask represents a range of IPv4 or IPv6 addresses
|
|
described by a base address and a length indicating how many bits
|
|
of the base address are relevant for matching purposes. These are
|
|
often given in string form. Eg, "10.0.0.0/8", or "fe80::/10".</doc>
|
|
<source-position filename="ginetaddressmask.h" line="52"/>
|
|
<implements name="Initable"/>
|
|
<constructor name="new" c:identifier="g_inet_address_mask_new" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25566">Creates a new #GInetAddressMask representing all addresses whose
|
|
first @length bits match @addr.</doc>
|
|
<source-position filename="ginetaddressmask.h" line="58"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25575">a new #GInetAddressMask, or %NULL on error</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="addr" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25568">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25569">number of bits of @addr to use</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_string" c:identifier="g_inet_address_mask_new_from_string" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25580">Parses @mask_string as an IP address and (optional) length, and
|
|
creates a new #GInetAddressMask. The length, if present, is
|
|
delimited by a "/". If it is not present, then the length is
|
|
assumed to be the full length of the address.</doc>
|
|
<source-position filename="ginetaddressmask.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25590">a new #GInetAddressMask corresponding to @string, or %NULL
|
|
on error.</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mask_string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25582">an IP address or address/length string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="equal" c:identifier="g_inet_address_mask_equal" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25508">Tests if @mask and @mask2 are the same mask.</doc>
|
|
<source-position filename="ginetaddressmask.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25515">whether @mask and @mask2 are the same mask</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25510">a #GInetAddressMask</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</instance-parameter>
|
|
<parameter name="mask2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25511">another #GInetAddressMask</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_address" c:identifier="g_inet_address_mask_get_address" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25520">Gets @mask's base address</doc>
|
|
<source-position filename="ginetaddressmask.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25526">@mask's base address</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25522">a #GInetAddressMask</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_family" c:identifier="g_inet_address_mask_get_family" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25531">Gets the #GSocketFamily of @mask's address</doc>
|
|
<source-position filename="ginetaddressmask.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25537">the #GSocketFamily of @mask's address</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25533">a #GInetAddressMask</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_length" c:identifier="g_inet_address_mask_get_length" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25542">Gets @mask's length</doc>
|
|
<source-position filename="ginetaddressmask.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25548">@mask's length</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25544">a #GInetAddressMask</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="matches" c:identifier="g_inet_address_mask_matches" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25553">Tests if @address falls within the range described by @mask.</doc>
|
|
<source-position filename="ginetaddressmask.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25560">whether @address falls within the range described by
|
|
@mask.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25555">a #GInetAddressMask</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25556">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_string" c:identifier="g_inet_address_mask_to_string" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25596">Converts @mask back to its corresponding string form.</doc>
|
|
<source-position filename="ginetaddressmask.h" line="66"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25602">a string corresponding to @mask.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mask" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25598">a #GInetAddressMask</doc>
|
|
<type name="InetAddressMask" c:type="GInetAddressMask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="address" writable="1" transfer-ownership="none">
|
|
<type name="InetAddress"/>
|
|
</property>
|
|
<property name="family" transfer-ownership="none">
|
|
<type name="SocketFamily"/>
|
|
</property>
|
|
<property name="length" writable="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="InetAddressMaskPrivate" c:type="GInetAddressMaskPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="InetAddressMaskClass" c:type="GInetAddressMaskClass" glib:is-gtype-struct-for="InetAddressMask">
|
|
<source-position filename="ginetaddressmask.h" line="52"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="InetAddressMaskPrivate" c:type="GInetAddressMaskPrivate" disguised="1">
|
|
<source-position filename="ginetaddressmask.h" line="38"/>
|
|
</record>
|
|
<record name="InetAddressPrivate" c:type="GInetAddressPrivate" disguised="1">
|
|
<source-position filename="ginetaddress.h" line="41"/>
|
|
</record>
|
|
<class name="InetSocketAddress" c:symbol-prefix="inet_socket_address" c:type="GInetSocketAddress" parent="SocketAddress" glib:type-name="GInetSocketAddress" glib:get-type="g_inet_socket_address_get_type" glib:type-struct="InetSocketAddressClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6622">An IPv4 or IPv6 socket address; that is, the combination of a
|
|
#GInetAddress and a port number.</doc>
|
|
<source-position filename="ginetsocketaddress.h" line="54"/>
|
|
<implements name="SocketConnectable"/>
|
|
<constructor name="new" c:identifier="g_inet_socket_address_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25734">Creates a new #GInetSocketAddress for @address and @port.</doc>
|
|
<source-position filename="ginetsocketaddress.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25741">a new #GInetSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25736">a #GInetAddress</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25737">a port number</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_string" c:identifier="g_inet_socket_address_new_from_string" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25746">Creates a new #GInetSocketAddress for @address and @port.
|
|
|
|
If @address is an IPv6 address, it can also contain a scope ID
|
|
(separated from the address by a `%`).</doc>
|
|
<source-position filename="ginetsocketaddress.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25756">a new #GInetSocketAddress, or %NULL if @address cannot be
|
|
parsed.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25748">the string form of an IP address</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25749">a port number</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_address" c:identifier="g_inet_socket_address_get_address" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25687">Gets @address's #GInetAddress.</doc>
|
|
<source-position filename="ginetsocketaddress.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25693">the #GInetAddress for @address, which must be
|
|
g_object_ref()'d if it will be stored</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25689">a #GInetSocketAddress</doc>
|
|
<type name="InetSocketAddress" c:type="GInetSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flowinfo" c:identifier="g_inet_socket_address_get_flowinfo" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25699">Gets the `sin6_flowinfo` field from @address,
|
|
which must be an IPv6 address.</doc>
|
|
<source-position filename="ginetsocketaddress.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25706">the flowinfo field</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25701">a %G_SOCKET_FAMILY_IPV6 #GInetSocketAddress</doc>
|
|
<type name="InetSocketAddress" c:type="GInetSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_port" c:identifier="g_inet_socket_address_get_port" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25711">Gets @address's port.</doc>
|
|
<source-position filename="ginetsocketaddress.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25717">the port for @address</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25713">a #GInetSocketAddress</doc>
|
|
<type name="InetSocketAddress" c:type="GInetSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_scope_id" c:identifier="g_inet_socket_address_get_scope_id" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25722">Gets the `sin6_scope_id` field from @address,
|
|
which must be an IPv6 address.</doc>
|
|
<source-position filename="ginetsocketaddress.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25729">the scope id field</doc>
|
|
<type name="guint32" c:type="guint32"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25724">a %G_SOCKET_FAMILY_IPV6 #GInetAddress</doc>
|
|
<type name="InetSocketAddress" c:type="GInetSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="address" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="InetAddress"/>
|
|
</property>
|
|
<property name="flowinfo" version="2.32" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="1983">The `sin6_flowinfo` field, for IPv6 addresses.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="port" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="scope-id" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="SocketAddress" c:type="GSocketAddress"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="InetSocketAddressPrivate" c:type="GInetSocketAddressPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="InetSocketAddressClass" c:type="GInetSocketAddressClass" glib:is-gtype-struct-for="InetSocketAddress">
|
|
<source-position filename="ginetsocketaddress.h" line="54"/>
|
|
<field name="parent_class">
|
|
<type name="SocketAddressClass" c:type="GSocketAddressClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="InetSocketAddressPrivate" c:type="GInetSocketAddressPrivate" disguised="1">
|
|
<source-position filename="ginetsocketaddress.h" line="41"/>
|
|
</record>
|
|
<interface name="Initable" c:symbol-prefix="initable" c:type="GInitable" version="2.22" glib:type-name="GInitable" glib:get-type="g_initable_get_type" glib:type-struct="InitableIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6632">#GInitable is implemented by objects that can fail during
|
|
initialization. If an object implements this interface then
|
|
it must be initialized as the first thing after construction,
|
|
either via g_initable_init() or g_async_initable_init_async()
|
|
(the latter is only available if it also implements #GAsyncInitable).
|
|
|
|
If the object is not initialized, or initialization returns with an
|
|
error, then all operations on the object except g_object_ref() and
|
|
g_object_unref() are considered to be invalid, and have undefined
|
|
behaviour. They will often fail with g_critical() or g_warning(), but
|
|
this must not be relied on.
|
|
|
|
Users of objects implementing this are not intended to use
|
|
the interface method directly, instead it will be used automatically
|
|
in various ways. For C applications you generally just call
|
|
g_initable_new() directly, or indirectly via a foo_thing_new() wrapper.
|
|
This will call g_initable_init() under the cover, returning %NULL and
|
|
setting a #GError on failure (at which point the instance is
|
|
unreferenced).
|
|
|
|
For bindings in languages where the native constructor supports
|
|
exceptions the binding could check for objects implemention %GInitable
|
|
during normal construction and automatically initialize them, throwing
|
|
an exception on failure.</doc>
|
|
<source-position filename="ginitable.h" line="66"/>
|
|
<function name="new" c:identifier="g_initable_new" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25814">Helper function for constructing #GInitable object. This is
|
|
similar to g_object_new() but also initializes the object
|
|
and returns %NULL, setting an error on failure.</doc>
|
|
<source-position filename="ginitable.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25829">a newly allocated
|
|
#GObject, or %NULL on error</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25816">a #GType supporting #GInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25817">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25818">a #GError location to store the error occurring, or %NULL to
|
|
ignore.</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="first_property_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25820">the name of the first property, or %NULL if no
|
|
properties</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25822">the value if the first property, followed by and other property
|
|
value pairs, and ended by %NULL.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="new_valist" c:identifier="g_initable_new_valist" version="2.22" introspectable="0" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25835">Helper function for constructing #GInitable object. This is
|
|
similar to g_object_new_valist() but also initializes the object
|
|
and returns %NULL, setting an error on failure.</doc>
|
|
<source-position filename="ginitable.h" line="96"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25849">a newly allocated
|
|
#GObject, or %NULL on error</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25837">a #GType supporting #GInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="first_property_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25838">the name of the first property, followed by
|
|
the value, and other property value pairs, and ended by %NULL.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="var_args" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25840">The var args list generated from @first_property_name.</doc>
|
|
<type name="va_list" c:type="va_list"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25841">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="newv" c:identifier="g_initable_newv" version="2.22" deprecated="1" deprecated-version="2.54" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25855">Helper function for constructing #GInitable object. This is
|
|
similar to g_object_newv() but also initializes the object
|
|
and returns %NULL, setting an error on failure.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
|
g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
|
|
<source-position filename="ginitable.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25868">a newly allocated
|
|
#GObject, or %NULL on error</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25857">a #GType supporting #GInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="n_parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25858">the number of parameters in @parameters</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25859">the parameters to use to construct the object</doc>
|
|
<array length="1" zero-terminated="0" c:type="GParameter*">
|
|
<type name="GObject.Parameter" c:type="GParameter"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25860">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="init" invoker="init" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25762">Initializes the object implementing the interface.
|
|
|
|
This method is intended for language bindings. If writing in C,
|
|
g_initable_new() should typically be used instead.
|
|
|
|
The object must be initialized before any real use after initial
|
|
construction, either with this function or g_async_initable_init_async().
|
|
|
|
Implementations may also support cancellation. If @cancellable is not %NULL,
|
|
then initialization can be cancelled by triggering the cancellable object
|
|
from another thread. If the operation was cancelled, the error
|
|
%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL and
|
|
the object doesn't support cancellable initialization the error
|
|
%G_IO_ERROR_NOT_SUPPORTED will be returned.
|
|
|
|
If the object is not initialized, or initialization returns with an
|
|
error, then all operations on the object except g_object_ref() and
|
|
g_object_unref() are considered to be invalid, and have undefined
|
|
behaviour. See the [introduction][ginitable] for more details.
|
|
|
|
Callers should not assume that a class which implements #GInitable can be
|
|
initialized multiple times, unless the class explicitly documents itself as
|
|
supporting this. Generally, a class’ implementation of init() can assume
|
|
(and assert) that it will only be called once. Previously, this documentation
|
|
recommended all #GInitable implementations should be idempotent; that
|
|
recommendation was relaxed in GLib 2.54.
|
|
|
|
If a class explicitly supports being initialized multiple times, it is
|
|
recommended that the method is idempotent: multiple calls with the same
|
|
arguments should return the same results. Only the first call initializes
|
|
the object; further calls return the result of the first call.
|
|
|
|
One reason why a class might need to support idempotent initialization is if
|
|
it is designed to be used via the singleton pattern, with a
|
|
#GObjectClass.constructor that sometimes returns an existing instance.
|
|
In this pattern, a caller would expect to be able to call g_initable_init()
|
|
on the result of g_object_new(), regardless of whether it is in fact a new
|
|
instance.</doc>
|
|
<source-position filename="ginitable.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25808">%TRUE if successful. If an error has occurred, this function will
|
|
return %FALSE and set @error appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25764">a #GInitable.</doc>
|
|
<type name="Initable" c:type="GInitable*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25765">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="init" c:identifier="g_initable_init" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25762">Initializes the object implementing the interface.
|
|
|
|
This method is intended for language bindings. If writing in C,
|
|
g_initable_new() should typically be used instead.
|
|
|
|
The object must be initialized before any real use after initial
|
|
construction, either with this function or g_async_initable_init_async().
|
|
|
|
Implementations may also support cancellation. If @cancellable is not %NULL,
|
|
then initialization can be cancelled by triggering the cancellable object
|
|
from another thread. If the operation was cancelled, the error
|
|
%G_IO_ERROR_CANCELLED will be returned. If @cancellable is not %NULL and
|
|
the object doesn't support cancellable initialization the error
|
|
%G_IO_ERROR_NOT_SUPPORTED will be returned.
|
|
|
|
If the object is not initialized, or initialization returns with an
|
|
error, then all operations on the object except g_object_ref() and
|
|
g_object_unref() are considered to be invalid, and have undefined
|
|
behaviour. See the [introduction][ginitable] for more details.
|
|
|
|
Callers should not assume that a class which implements #GInitable can be
|
|
initialized multiple times, unless the class explicitly documents itself as
|
|
supporting this. Generally, a class’ implementation of init() can assume
|
|
(and assert) that it will only be called once. Previously, this documentation
|
|
recommended all #GInitable implementations should be idempotent; that
|
|
recommendation was relaxed in GLib 2.54.
|
|
|
|
If a class explicitly supports being initialized multiple times, it is
|
|
recommended that the method is idempotent: multiple calls with the same
|
|
arguments should return the same results. Only the first call initializes
|
|
the object; further calls return the result of the first call.
|
|
|
|
One reason why a class might need to support idempotent initialization is if
|
|
it is designed to be used via the singleton pattern, with a
|
|
#GObjectClass.constructor that sometimes returns an existing instance.
|
|
In this pattern, a caller would expect to be able to call g_initable_init()
|
|
on the result of g_object_new(), regardless of whether it is in fact a new
|
|
instance.</doc>
|
|
<source-position filename="ginitable.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25808">%TRUE if successful. If an error has occurred, this function will
|
|
return %FALSE and set @error appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25764">a #GInitable.</doc>
|
|
<type name="Initable" c:type="GInitable*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25765">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="InitableIface" c:type="GInitableIface" glib:is-gtype-struct-for="Initable" version="2.22">
|
|
<doc xml:space="preserve" filename="ginitable.h" line="47">Provides an interface for initializing object such that initialization
|
|
may fail.</doc>
|
|
<source-position filename="ginitable.h" line="66"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="ginitable.h" line="49">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="init">
|
|
<callback name="init" throws="1">
|
|
<source-position filename="ginitable.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25808">%TRUE if successful. If an error has occurred, this function will
|
|
return %FALSE and set @error appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="initable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25764">a #GInitable.</doc>
|
|
<type name="Initable" c:type="GInitable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25765">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="InputMessage" c:type="GInputMessage" version="2.48">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="439">Structure used for scatter/gather data input when receiving multiple
|
|
messages or packets in one go. You generally pass in an array of empty
|
|
#GInputVectors and the operation will use all the buffers as if they
|
|
were one buffer, and will set @bytes_received to the total number of bytes
|
|
received across all #GInputVectors.
|
|
|
|
This structure closely mirrors `struct mmsghdr` and `struct msghdr` from
|
|
the POSIX sockets API (see `man 2 recvmmsg`).
|
|
|
|
If @address is non-%NULL then it is set to the source address the message
|
|
was received from, and the caller must free it afterwards.
|
|
|
|
If @control_messages is non-%NULL then it is set to an array of control
|
|
messages received with the message (if any), and the caller must free it
|
|
afterwards. @num_control_messages is set to the number of elements in
|
|
this array, which may be zero.
|
|
|
|
Flags relevant to this message will be returned in @flags. For example,
|
|
`MSG_EOR` or `MSG_TRUNC`.</doc>
|
|
<source-position filename="giotypes.h" line="491"/>
|
|
<field name="address" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="441">return location
|
|
for a #GSocketAddress, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress**"/>
|
|
</field>
|
|
<field name="vectors" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="443">pointer to an
|
|
array of input vectors</doc>
|
|
<array length="2" zero-terminated="0" c:type="GInputVector*">
|
|
<type name="InputVector" c:type="GInputVector"/>
|
|
</array>
|
|
</field>
|
|
<field name="num_vectors" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="445">the number of input vectors pointed to by @vectors</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="bytes_received" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="446">will be set to the number of bytes that have been
|
|
received</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</field>
|
|
<field name="flags" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="448">collection of #GSocketMsgFlags for the received message,
|
|
outputted by the call</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</field>
|
|
<field name="control_messages" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="450">return location for a
|
|
caller-allocated array of #GSocketControlMessages, or %NULL</doc>
|
|
<array length="6" zero-terminated="0" c:type="GSocketControlMessage***">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage**"/>
|
|
</array>
|
|
</field>
|
|
<field name="num_control_messages" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="453">return location for the number of
|
|
elements in @control_messages</doc>
|
|
<type name="guint" c:type="guint*"/>
|
|
</field>
|
|
</record>
|
|
<class name="InputStream" c:symbol-prefix="input_stream" c:type="GInputStream" parent="GObject.Object" abstract="1" glib:type-name="GInputStream" glib:get-type="g_input_stream_get_type" glib:type-struct="InputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6665">#GInputStream has functions to read from a stream (g_input_stream_read()),
|
|
to close a stream (g_input_stream_close()) and to skip some content
|
|
(g_input_stream_skip()).
|
|
|
|
To copy the content of an input stream to an output stream without
|
|
manually handling the reads and writes, use g_output_stream_splice().
|
|
|
|
See the documentation for #GIOStream for details of thread safety of
|
|
streaming APIs.
|
|
|
|
All of these functions have async variants too.</doc>
|
|
<source-position filename="ginputstream.h" line="110"/>
|
|
<virtual-method name="close_async" invoker="close_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25918">Requests an asynchronous closes of the stream, releasing resources related to it.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_input_stream_close_finish() to get the result of the
|
|
operation.
|
|
|
|
For behaviour details see g_input_stream_close().
|
|
|
|
The asynchronous methods have a default fallback that uses threads to implement
|
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
|
override one you must override all.</doc>
|
|
<source-position filename="ginputstream.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25920">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25921">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25922">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25923">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25924">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_finish" invoker="close_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25939">Finishes closing a stream asynchronously, started from g_input_stream_close_async().</doc>
|
|
<source-position filename="ginputstream.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25948">%TRUE if the stream was closed successfully.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25941">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25942">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_fn" throws="1">
|
|
<source-position filename="ginputstream.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_async" invoker="read_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26089">Request an asynchronous read of @count bytes from the stream into the buffer
|
|
starting at @buffer. When the operation is finished @callback will be called.
|
|
You can then call g_input_stream_read_finish() to get the result of the
|
|
operation.
|
|
|
|
During an async request no other sync and async calls are allowed on @stream, and will
|
|
result in %G_IO_ERROR_PENDING errors.
|
|
|
|
A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes read into the buffer will be passed to the
|
|
callback. It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file, but generally we try to read
|
|
as many bytes as requested. Zero is returned on end of file
|
|
(or if @count is zero), but never otherwise.
|
|
|
|
Any outstanding i/o request with higher priority (lower numerical value) will
|
|
be executed before an outstanding request with lower priority. Default
|
|
priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads to implement
|
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
|
override one you must override all.</doc>
|
|
<source-position filename="ginputstream.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26091">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26092">
|
|
a buffer to read data into (which should be at least count bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26094">the number of bytes that will be read from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26095">the [I/O priority][io-priority]
|
|
of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26097">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26098">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26099">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_finish" invoker="read_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26212">Finishes an asynchronous stream read operation.</doc>
|
|
<source-position filename="ginputstream.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26221">number of bytes read in, or -1 on error, or 0 on end of file.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26214">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26215">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_fn" throws="1">
|
|
<source-position filename="ginputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="void*"/>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="skip" invoker="skip" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26239">Tries to skip @count bytes from the stream. Will block during the operation.
|
|
|
|
This is identical to g_input_stream_read(), from a behaviour standpoint,
|
|
but the bytes that are skipped are not returned to the user. Some
|
|
streams have an implementation that is more efficient than reading the data.
|
|
|
|
This function is optional for inherited classes, as the default implementation
|
|
emulates it using read.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.</doc>
|
|
<source-position filename="ginputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26261">Number of bytes skipped, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26241">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26242">the number of bytes that will be skipped from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26243">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="skip_async" invoker="skip_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26265">Request an asynchronous skip of @count bytes from the stream.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_input_stream_skip_finish() to get the result
|
|
of the operation.
|
|
|
|
During an async request no other sync and async calls are allowed,
|
|
and will result in %G_IO_ERROR_PENDING errors.
|
|
|
|
A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes skipped will be passed to the callback.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file, but generally we try to skip
|
|
as many bytes as requested. Zero is returned on end of file
|
|
(or if @count is zero), but never otherwise.
|
|
|
|
Any outstanding i/o request with higher priority (lower numerical value)
|
|
will be executed before an outstanding request with lower priority.
|
|
Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads to
|
|
implement asynchronicity, so they are optional for inheriting classes.
|
|
However, if you override one, you must override all.</doc>
|
|
<source-position filename="ginputstream.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26267">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26268">the number of bytes that will be skipped from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26269">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26270">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26271">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26272">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="skip_finish" invoker="skip_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26300">Finishes a stream skip operation.</doc>
|
|
<source-position filename="ginputstream.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26309">the size of the bytes skipped, or `-1` on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26302">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26303">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="clear_pending" c:identifier="g_input_stream_clear_pending">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25876">Clears the pending flag on @stream.</doc>
|
|
<source-position filename="ginputstream.h" line="212"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25878">input stream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close" c:identifier="g_input_stream_close" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25884">Closes the stream, releasing resources related to it.
|
|
|
|
Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
|
|
Closing a stream multiple times will not return an error.
|
|
|
|
Streams will be automatically closed when the last reference
|
|
is dropped, but you might want to call this function to make sure
|
|
resources are released as early as possible.
|
|
|
|
Some streams might keep the backing store of the stream (e.g. a file descriptor)
|
|
open after the stream is closed. See the documentation for the individual
|
|
stream for details.
|
|
|
|
On failure the first error that happened will be reported, but the close
|
|
operation will finish as much as possible. A stream that failed to
|
|
close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
|
|
is important to check and report the error to the user.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
Cancelling a close will still leave the stream closed, but some streams
|
|
can use a faster close that doesn't block to e.g. check errors.</doc>
|
|
<source-position filename="ginputstream.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25914">%TRUE on success, %FALSE on failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25886">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25887">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_async" c:identifier="g_input_stream_close_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25918">Requests an asynchronous closes of the stream, releasing resources related to it.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_input_stream_close_finish() to get the result of the
|
|
operation.
|
|
|
|
For behaviour details see g_input_stream_close().
|
|
|
|
The asynchronous methods have a default fallback that uses threads to implement
|
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
|
override one you must override all.</doc>
|
|
<source-position filename="ginputstream.h" line="192"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25920">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25921">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25922">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25923">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25924">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_finish" c:identifier="g_input_stream_close_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25939">Finishes closing a stream asynchronously, started from g_input_stream_close_async().</doc>
|
|
<source-position filename="ginputstream.h" line="198"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25948">%TRUE if the stream was closed successfully.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25941">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25942">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_pending" c:identifier="g_input_stream_has_pending">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25952">Checks if an input stream has pending actions.</doc>
|
|
<source-position filename="ginputstream.h" line="207"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25958">%TRUE if @stream has pending actions.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25954">input stream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_closed" c:identifier="g_input_stream_is_closed">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25962">Checks if an input stream is closed.</doc>
|
|
<source-position filename="ginputstream.h" line="205"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25968">%TRUE if the stream is closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25964">input stream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read" c:identifier="g_input_stream_read" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25972">Tries to read @count bytes from the stream into the buffer starting at
|
|
@buffer. Will block during this read.
|
|
|
|
If count is zero returns zero and does nothing. A value of @count
|
|
larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes read into the buffer is returned.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file. Zero is returned on end of file
|
|
(or if @count is zero), but never otherwise.
|
|
|
|
The returned @buffer is not a nul-terminated string, it can contain nul bytes
|
|
at any position, and this function doesn't nul-terminate the @buffer.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="ginputstream.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26003">Number of bytes read, or -1 on error, or 0 on end of file.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25974">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25975">
|
|
a buffer to read data into (which should be at least count bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25977">the number of bytes that will be read from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25978">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_all" c:identifier="g_input_stream_read_all" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26007">Tries to read @count bytes from the stream into the buffer starting at
|
|
@buffer. Will block during this read.
|
|
|
|
This function is similar to g_input_stream_read(), except it tries to
|
|
read as many bytes as requested, only stopping on an error or end of stream.
|
|
|
|
On a successful read of @count bytes, or if we reached the end of the
|
|
stream, %TRUE is returned, and @bytes_read is set to the number of bytes
|
|
read into @buffer.
|
|
|
|
If there is an error during the operation %FALSE is returned and @error
|
|
is set to indicate the error status.
|
|
|
|
As a special exception to the normal conventions for functions that
|
|
use #GError, if this function returns %FALSE (and sets @error) then
|
|
@bytes_read will be set to the number of bytes that were successfully
|
|
read before the error was encountered. This functionality is only
|
|
available from C. If you need it from another language then you must
|
|
write your own loop around g_input_stream_read().</doc>
|
|
<source-position filename="ginputstream.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26037">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26009">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26010">
|
|
a buffer to read data into (which should be at least count bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26012">the number of bytes that will be read from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_read" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26013">location to store the number of bytes that was read from the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26014">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_all_async" c:identifier="g_input_stream_read_all_async" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26041">Request an asynchronous read of @count bytes from the stream into the
|
|
buffer starting at @buffer.
|
|
|
|
This is the asynchronous equivalent of g_input_stream_read_all().
|
|
|
|
Call g_input_stream_read_all_finish() to collect the result.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.</doc>
|
|
<source-position filename="ginputstream.h" line="156"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26043">A #GInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26044">
|
|
a buffer to read data into (which should be at least count bytes long)</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26046">the number of bytes that will be read from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26047">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26048">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26049">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26050">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_all_finish" c:identifier="g_input_stream_read_all_finish" version="2.44" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26067">Finishes an asynchronous stream read operation started with
|
|
g_input_stream_read_all_async().
|
|
|
|
As a special exception to the normal conventions for functions that
|
|
use #GError, if this function returns %FALSE (and sets @error) then
|
|
@bytes_read will be set to the number of bytes that were successfully
|
|
read before the error was encountered. This functionality is only
|
|
available from C. If you need it from another language then you must
|
|
write your own loop around g_input_stream_read_async().</doc>
|
|
<source-position filename="ginputstream.h" line="164"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26084">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26069">a #GInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26070">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="bytes_read" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26071">location to store the number of bytes that was read from the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_async" c:identifier="g_input_stream_read_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26089">Request an asynchronous read of @count bytes from the stream into the buffer
|
|
starting at @buffer. When the operation is finished @callback will be called.
|
|
You can then call g_input_stream_read_finish() to get the result of the
|
|
operation.
|
|
|
|
During an async request no other sync and async calls are allowed on @stream, and will
|
|
result in %G_IO_ERROR_PENDING errors.
|
|
|
|
A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes read into the buffer will be passed to the
|
|
callback. It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file, but generally we try to read
|
|
as many bytes as requested. Zero is returned on end of file
|
|
(or if @count is zero), but never otherwise.
|
|
|
|
Any outstanding i/o request with higher priority (lower numerical value) will
|
|
be executed before an outstanding request with lower priority. Default
|
|
priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads to implement
|
|
asynchronicity, so they are optional for inheriting classes. However, if you
|
|
override one you must override all.</doc>
|
|
<source-position filename="ginputstream.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26091">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26092">
|
|
a buffer to read data into (which should be at least count bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26094">the number of bytes that will be read from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26095">the [I/O priority][io-priority]
|
|
of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26097">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26098">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26099">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_bytes" c:identifier="g_input_stream_read_bytes" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26127">Like g_input_stream_read(), this tries to read @count bytes from
|
|
the stream in a blocking fashion. However, rather than reading into
|
|
a user-supplied buffer, this will create a new #GBytes containing
|
|
the data that was read. This may be easier to use from language
|
|
bindings.
|
|
|
|
If count is zero, returns a zero-length #GBytes and does nothing. A
|
|
value of @count larger than %G_MAXSSIZE will cause a
|
|
%G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, a new #GBytes is returned. It is not an error if the
|
|
size of this object is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file. A zero-length #GBytes is
|
|
returned on end of file (or if @count is zero), but never
|
|
otherwise.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
On error %NULL is returned and @error is set accordingly.</doc>
|
|
<source-position filename="ginputstream.h" line="129"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26159">a new #GBytes, or %NULL on error</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26129">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26130">maximum number of bytes that will be read from the stream. Common
|
|
values include 4096 and 8192.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26132">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_bytes_async" c:identifier="g_input_stream_read_bytes_async" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26164">Request an asynchronous read of @count bytes from the stream into a
|
|
new #GBytes. When the operation is finished @callback will be
|
|
called. You can then call g_input_stream_read_bytes_finish() to get the
|
|
result of the operation.
|
|
|
|
During an async request no other sync and async calls are allowed
|
|
on @stream, and will result in %G_IO_ERROR_PENDING errors.
|
|
|
|
A value of @count larger than %G_MAXSSIZE will cause a
|
|
%G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the new #GBytes will be passed to the callback. It is
|
|
not an error if this is smaller than the requested size, as it can
|
|
happen e.g. near the end of a file, but generally we try to read as
|
|
many bytes as requested. Zero is returned on end of file (or if
|
|
@count is zero), but never otherwise.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.</doc>
|
|
<source-position filename="ginputstream.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26166">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26167">the number of bytes that will be read from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26168">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26169">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26170">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26171">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_bytes_finish" c:identifier="g_input_stream_read_bytes_finish" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26198">Finishes an asynchronous stream read-into-#GBytes operation.</doc>
|
|
<source-position filename="ginputstream.h" line="177"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26207">the newly-allocated #GBytes, or %NULL on error</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26200">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26201">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_finish" c:identifier="g_input_stream_read_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26212">Finishes an asynchronous stream read operation.</doc>
|
|
<source-position filename="ginputstream.h" line="151"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26221">number of bytes read in, or -1 on error, or 0 on end of file.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26214">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26215">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pending" c:identifier="g_input_stream_set_pending" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26225">Sets @stream to have actions pending. If the pending flag is
|
|
already set or @stream is closed, it will return %FALSE and set
|
|
@error.</doc>
|
|
<source-position filename="ginputstream.h" line="209"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26235">%TRUE if pending was previously unset and is now set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26227">input stream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip" c:identifier="g_input_stream_skip" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26239">Tries to skip @count bytes from the stream. Will block during the operation.
|
|
|
|
This is identical to g_input_stream_read(), from a behaviour standpoint,
|
|
but the bytes that are skipped are not returned to the user. Some
|
|
streams have an implementation that is more efficient than reading the data.
|
|
|
|
This function is optional for inherited classes, as the default implementation
|
|
emulates it using read.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.</doc>
|
|
<source-position filename="ginputstream.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26261">Number of bytes skipped, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26241">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26242">the number of bytes that will be skipped from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26243">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip_async" c:identifier="g_input_stream_skip_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26265">Request an asynchronous skip of @count bytes from the stream.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_input_stream_skip_finish() to get the result
|
|
of the operation.
|
|
|
|
During an async request no other sync and async calls are allowed,
|
|
and will result in %G_IO_ERROR_PENDING errors.
|
|
|
|
A value of @count larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes skipped will be passed to the callback.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. near the end of a file, but generally we try to skip
|
|
as many bytes as requested. Zero is returned on end of file
|
|
(or if @count is zero), but never otherwise.
|
|
|
|
Any outstanding i/o request with higher priority (lower numerical value)
|
|
will be executed before an outstanding request with lower priority.
|
|
Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads to
|
|
implement asynchronicity, so they are optional for inheriting classes.
|
|
However, if you override one, you must override all.</doc>
|
|
<source-position filename="ginputstream.h" line="181"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26267">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26268">the number of bytes that will be skipped from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26269">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26270">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26271">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26272">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="skip_finish" c:identifier="g_input_stream_skip_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26300">Finishes a stream skip operation.</doc>
|
|
<source-position filename="ginputstream.h" line="188"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26309">the size of the bytes skipped, or `-1` on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26302">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26303">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="InputStreamPrivate" c:type="GInputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="InputStreamClass" c:type="GInputStreamClass" glib:is-gtype-struct-for="InputStream">
|
|
<source-position filename="ginputstream.h" line="110"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="read_fn">
|
|
<callback name="read_fn" throws="1">
|
|
<source-position filename="ginputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="void*"/>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="skip">
|
|
<callback name="skip" throws="1">
|
|
<source-position filename="ginputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26261">Number of bytes skipped, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26241">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26242">the number of bytes that will be skipped from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26243">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_fn">
|
|
<callback name="close_fn" throws="1">
|
|
<source-position filename="ginputstream.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="read_async">
|
|
<callback name="read_async">
|
|
<source-position filename="ginputstream.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26091">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" direction="out" caller-allocates="1" transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26092">
|
|
a buffer to read data into (which should be at least count bytes long).</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26094">the number of bytes that will be read from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26095">the [I/O priority][io-priority]
|
|
of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26097">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26098">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26099">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="read_finish">
|
|
<callback name="read_finish" throws="1">
|
|
<source-position filename="ginputstream.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26221">number of bytes read in, or -1 on error, or 0 on end of file.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26214">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26215">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="skip_async">
|
|
<callback name="skip_async">
|
|
<source-position filename="ginputstream.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26267">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26268">the number of bytes that will be skipped from the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26269">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26270">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26271">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26272">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="skip_finish">
|
|
<callback name="skip_finish" throws="1">
|
|
<source-position filename="ginputstream.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26309">the size of the bytes skipped, or `-1` on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26302">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26303">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_async">
|
|
<callback name="close_async">
|
|
<source-position filename="ginputstream.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25920">A #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25921">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25922">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25923">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25924">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_finish">
|
|
<callback name="close_finish" throws="1">
|
|
<source-position filename="ginputstream.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25948">%TRUE if the stream was closed successfully.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25941">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25942">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="ginputstream.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="ginputstream.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="ginputstream.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="ginputstream.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="ginputstream.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="InputStreamPrivate" c:type="GInputStreamPrivate" disguised="1">
|
|
<source-position filename="ginputstream.h" line="45"/>
|
|
</record>
|
|
<record name="InputVector" c:type="GInputVector" version="2.22">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="420">Structure used for scatter/gather data input.
|
|
You generally pass in an array of #GInputVectors
|
|
and the operation will store the read data starting in the
|
|
first buffer, switching to the next as needed.</doc>
|
|
<source-position filename="giotypes.h" line="437"/>
|
|
<field name="buffer" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="422">Pointer to a buffer where data will be written.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</field>
|
|
<field name="size" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="423">the available size in @buffer.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</field>
|
|
</record>
|
|
<function-macro name="LOADABLE_ICON" c:identifier="G_LOADABLE_ICON" introspectable="0">
|
|
<source-position filename="gloadableicon.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="LOADABLE_ICON_GET_IFACE" c:identifier="G_LOADABLE_ICON_GET_IFACE" introspectable="0">
|
|
<source-position filename="gloadableicon.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<interface name="ListModel" c:symbol-prefix="list_model" c:type="GListModel" glib:type-name="GListModel" glib:get-type="g_list_model_get_type" glib:type-struct="ListModelInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6774">#GListModel is an interface that represents a mutable list of
|
|
#GObjects. Its main intention is as a model for various widgets in
|
|
user interfaces, such as list views, but it can also be used as a
|
|
convenient method of returning lists of data, with support for
|
|
updates.
|
|
|
|
Each object in the list may also report changes in itself via some
|
|
mechanism (normally the #GObject::notify signal). Taken together
|
|
with the #GListModel::items-changed signal, this provides for a list
|
|
that can change its membership, and in which the members can change
|
|
their individual properties.
|
|
|
|
A good example would be the list of visible wireless network access
|
|
points, where each access point can report dynamic properties such as
|
|
signal strength.
|
|
|
|
It is important to note that the #GListModel itself does not report
|
|
changes to the individual items. It only reports changes to the list
|
|
membership. If you want to observe changes to the objects themselves
|
|
then you need to connect signals to the objects that you are
|
|
interested in.
|
|
|
|
All items in a #GListModel are of (or derived from) the same type.
|
|
g_list_model_get_item_type() returns that type. The type may be an
|
|
interface, in which case all objects in the list must implement it.
|
|
|
|
The semantics are close to that of an array:
|
|
g_list_model_get_n_items() returns the number of items in the list and
|
|
g_list_model_get_item() returns an item at a (0-based) position. In
|
|
order to allow implementations to calculate the list length lazily,
|
|
you can also iterate over items: starting from 0, repeatedly call
|
|
g_list_model_get_item() until it returns %NULL.
|
|
|
|
An implementation may create objects lazily, but must take care to
|
|
return the same object for a given position until all references to
|
|
it are gone.
|
|
|
|
On the other side, a consumer is expected only to hold references on
|
|
objects that are currently "user visible", in order to faciliate the
|
|
maximum level of laziness in the implementation of the list and to
|
|
reduce the required number of signal connections at a given time.
|
|
|
|
This interface is intended only to be used from a single thread. The
|
|
thread in which it is appropriate to use it depends on the particular
|
|
implementation, but typically it will be from the thread that owns
|
|
the [thread-default main context][g-main-context-push-thread-default]
|
|
in effect at the time that the model was created.</doc>
|
|
<source-position filename="glistmodel.h" line="48"/>
|
|
<virtual-method name="get_item" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2079">Get the item at @position. If @position is greater than the number of
|
|
items in @list, %NULL is returned.
|
|
|
|
%NULL is never returned for an index that is smaller than the length
|
|
of the list. See g_list_model_get_n_items().</doc>
|
|
<source-position filename="glistmodel.h" line="46"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2090">the object at @position.</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2081">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2082">the position of the item to fetch</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_item_type" invoker="get_item_type" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26962">Gets the type of the items in @list. All items returned from
|
|
g_list_model_get_type() are of that type or a subtype, or are an
|
|
implementation of that interface.
|
|
|
|
The item type of a #GListModel can not change during the life of the
|
|
model.</doc>
|
|
<source-position filename="glistmodel.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26973">the #GType of the items contained in @list.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26964">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_n_items" invoker="get_n_items" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26978">Gets the number of items in @list.
|
|
|
|
Depending on the model implementation, calling this function may be
|
|
less efficient than iterating the list with increasing values for
|
|
@position until g_list_model_get_item() returns %NULL.</doc>
|
|
<source-position filename="glistmodel.h" line="44"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26988">the number of items in @list.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26980">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_item" c:identifier="g_list_model_get_item" shadowed-by="get_object" version="2.44" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26946">Get the item at @position. If @position is greater than the number of
|
|
items in @list, %NULL is returned.
|
|
|
|
%NULL is never returned for an index that is smaller than the length
|
|
of the list. See g_list_model_get_n_items().</doc>
|
|
<source-position filename="glistmodel.h" line="57"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26957">the item at @position.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26948">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26949">the position of the item to fetch</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_item_type" c:identifier="g_list_model_get_item_type" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26962">Gets the type of the items in @list. All items returned from
|
|
g_list_model_get_type() are of that type or a subtype, or are an
|
|
implementation of that interface.
|
|
|
|
The item type of a #GListModel can not change during the life of the
|
|
model.</doc>
|
|
<source-position filename="glistmodel.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26973">the #GType of the items contained in @list.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26964">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_n_items" c:identifier="g_list_model_get_n_items" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26978">Gets the number of items in @list.
|
|
|
|
Depending on the model implementation, calling this function may be
|
|
less efficient than iterating the list with increasing values for
|
|
@position until g_list_model_get_item() returns %NULL.</doc>
|
|
<source-position filename="glistmodel.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26988">the number of items in @list.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26980">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_object" c:identifier="g_list_model_get_object" shadows="get_item" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26993">Get the item at @position. If @position is greater than the number of
|
|
items in @list, %NULL is returned.
|
|
|
|
%NULL is never returned for an index that is smaller than the length
|
|
of the list. See g_list_model_get_n_items().</doc>
|
|
<source-position filename="glistmodel.h" line="61"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27004">the object at @position.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26995">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26996">the position of the item to fetch</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="items_changed" c:identifier="g_list_model_items_changed" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27009">Emits the #GListModel::items-changed signal on @list.
|
|
|
|
This function should only be called by classes implementing
|
|
#GListModel. It has to be called after the internal representation
|
|
of @list has been updated, because handlers connected to this signal
|
|
might query the new state of the list.
|
|
|
|
Implementations must only make changes to the model (as visible to
|
|
its consumer) in places that will not cause problems for that
|
|
consumer. For models that are driven directly by a write API (such
|
|
as #GListStore), changes can be reported in response to uses of that
|
|
API. For models that represent remote data, changes should only be
|
|
made from a fresh mainloop dispatch. It is particularly not
|
|
permitted to make changes in response to a call to the #GListModel
|
|
consumer API.
|
|
|
|
Stated another way: in general, it is assumed that code making a
|
|
series of accesses to the model via the API, without returning to the
|
|
mainloop, and without calling other code, will continue to view the
|
|
same contents of the model.</doc>
|
|
<source-position filename="glistmodel.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27011">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27012">the position at which @list changed</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="removed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27013">the number of items removed</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="added" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27014">the number of items added</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="items-changed" when="last" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2048">This signal is emitted whenever items were added to or removed
|
|
from @list. At @position, @removed items were removed and @added
|
|
items were added in their place.
|
|
|
|
Note: If @removed != @added, the positions of all later items
|
|
in the model change.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2051">the position at which @list changed</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="removed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2052">the number of items removed</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="added" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2053">the number of items added</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="ListModelInterface" c:type="GListModelInterface" glib:is-gtype-struct-for="ListModel" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2066">The virtual function table for #GListModel.</doc>
|
|
<source-position filename="glistmodel.h" line="48"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2068">parent #GTypeInterface</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="get_item_type">
|
|
<callback name="get_item_type">
|
|
<source-position filename="glistmodel.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26973">the #GType of the items contained in @list.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26964">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_n_items">
|
|
<callback name="get_n_items">
|
|
<source-position filename="glistmodel.h" line="44"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26988">the number of items in @list.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26980">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_item">
|
|
<callback name="get_item">
|
|
<source-position filename="glistmodel.h" line="46"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2090">the object at @position.</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2081">a #GListModel</doc>
|
|
<type name="ListModel" c:type="GListModel*"/>
|
|
</parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2082">the position of the item to fetch</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="ListStore" c:symbol-prefix="list_store" c:type="GListStore" parent="GObject.Object" glib:type-name="GListStore" glib:get-type="g_list_store_get_type" glib:type-struct="ListStoreClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6831">#GListStore is a simple implementation of #GListModel that stores all
|
|
items in memory.
|
|
|
|
It provides insertions, deletions, and lookups in logarithmic time
|
|
with a fast path for the common case of iterating the list linearly.</doc>
|
|
<source-position filename="gliststore.h" line="36"/>
|
|
<implements name="ListModel"/>
|
|
<constructor name="new" c:identifier="g_list_store_new" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27097">Creates a new #GListStore with items of type @item_type. @item_type
|
|
must be a subclass of #GObject.</doc>
|
|
<source-position filename="gliststore.h" line="39"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27104">a new #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="item_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27099">the #GType of items in the list</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="append" c:identifier="g_list_store_append" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27041">Appends @item to @store. @item must be of type #GListStore:item-type.
|
|
|
|
This function takes a ref on @item.
|
|
|
|
Use g_list_store_splice() to append multiple items at the same time
|
|
efficiently.</doc>
|
|
<source-position filename="gliststore.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="store" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27043">a #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27044">the new item</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="insert" c:identifier="g_list_store_insert" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27057">Inserts @item into @store at @position. @item must be of type
|
|
#GListStore:item-type or derived from it. @position must be smaller
|
|
than the length of the list, or equal to it to append.
|
|
|
|
This function takes a ref on @item.
|
|
|
|
Use g_list_store_splice() to insert multiple items at the same time
|
|
efficiently.</doc>
|
|
<source-position filename="gliststore.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="store" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27059">a #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27060">the position at which to insert the new item</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27061">the new item</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="insert_sorted" c:identifier="g_list_store_insert_sorted" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27076">Inserts @item into @store at a position to be determined by the
|
|
@compare_func.
|
|
|
|
The list must already be sorted before calling this function or the
|
|
result is undefined. Usually you would approach this by only ever
|
|
inserting items by way of this function.
|
|
|
|
This function takes a ref on @item.</doc>
|
|
<source-position filename="gliststore.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27092">the position at which @item was inserted</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="store" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27078">a #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27079">the new item</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="compare_func" transfer-ownership="none" scope="call" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27080">pairwise comparison function for sorting</doc>
|
|
<type name="GLib.CompareDataFunc" c:type="GCompareDataFunc"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27081">user data for @compare_func</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove" c:identifier="g_list_store_remove" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27109">Removes the item from @store that is at @position. @position must be
|
|
smaller than the current length of the list.
|
|
|
|
Use g_list_store_splice() to remove multiple items at the same time
|
|
efficiently.</doc>
|
|
<source-position filename="gliststore.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="store" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27111">a #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27112">the position of the item that is to be removed</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_all" c:identifier="g_list_store_remove_all" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27124">Removes all items from @store.</doc>
|
|
<source-position filename="gliststore.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="store" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27126">a #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="sort" c:identifier="g_list_store_sort" version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27134">Sort the items in @store according to @compare_func.</doc>
|
|
<source-position filename="gliststore.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="store" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27136">a #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</instance-parameter>
|
|
<parameter name="compare_func" transfer-ownership="none" scope="call" closure="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27137">pairwise comparison function for sorting</doc>
|
|
<type name="GLib.CompareDataFunc" c:type="GCompareDataFunc"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27138">user data for @compare_func</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="splice" c:identifier="g_list_store_splice" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27146">Changes @store by removing @n_removals items and adding @n_additions
|
|
items to it. @additions must contain @n_additions items of type
|
|
#GListStore:item-type. %NULL is not permitted.
|
|
|
|
This function is more efficient than g_list_store_insert() and
|
|
g_list_store_remove(), because it only emits
|
|
#GListModel::items-changed once for the change.
|
|
|
|
This function takes a ref on each item in @additions.
|
|
|
|
The parameters @position and @n_removals must be correct (ie:
|
|
@position + @n_removals must be less than or equal to the length of
|
|
the list at the time this function is called).</doc>
|
|
<source-position filename="gliststore.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="store" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27148">a #GListStore</doc>
|
|
<type name="ListStore" c:type="GListStore*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27149">the position at which to make the change</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="n_removals" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27150">the number of items to remove</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="additions" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27151">the items to add</doc>
|
|
<array length="3" zero-terminated="0" c:type="gpointer*">
|
|
<type name="GObject.Object"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_additions" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27152">the number of items to add</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="item-type" version="2.44" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2103">The type of items contained in this list store. Items must be
|
|
subclasses of #GObject.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</property>
|
|
</class>
|
|
<record name="ListStoreClass" c:type="GListStoreClass" glib:is-gtype-struct-for="ListStore">
|
|
<source-position filename="gliststore.h" line="36"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<interface name="LoadableIcon" c:symbol-prefix="loadable_icon" c:type="GLoadableIcon" glib:type-name="GLoadableIcon" glib:get-type="g_loadable_icon_get_type" glib:type-struct="LoadableIconIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6845">Extends the #GIcon interface and adds the ability to
|
|
load icons from streams.</doc>
|
|
<source-position filename="gloadableicon.h" line="74"/>
|
|
<prerequisite name="Icon"/>
|
|
<virtual-method name="load" invoker="load" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27172">Loads a loadable icon. For the asynchronous version of this function,
|
|
see g_loadable_icon_load_async().</doc>
|
|
<source-position filename="gloadableicon.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27186">a #GInputStream to read the icon from.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27174">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27175">an integer.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27176">a location to store the type of the loaded
|
|
icon, %NULL to ignore.</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27178">optional #GCancellable object, %NULL to
|
|
ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="load_async" invoker="load_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27190">Loads an icon asynchronously. To finish this function, see
|
|
g_loadable_icon_load_finish(). For the synchronous, blocking
|
|
version of this function, see g_loadable_icon_load().</doc>
|
|
<source-position filename="gloadableicon.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27192">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27193">an integer.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27194">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27195">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27197">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="load_finish" invoker="load_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27205">Finishes an asynchronous icon load started in g_loadable_icon_load_async().</doc>
|
|
<source-position filename="gloadableicon.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27216">a #GInputStream to read the icon from.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27207">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27208">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27209">a location to store the type of the loaded
|
|
icon, %NULL to ignore.</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="load" c:identifier="g_loadable_icon_load" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27172">Loads a loadable icon. For the asynchronous version of this function,
|
|
see g_loadable_icon_load_async().</doc>
|
|
<source-position filename="gloadableicon.h" line="80"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27186">a #GInputStream to read the icon from.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27174">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27175">an integer.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27176">a location to store the type of the loaded
|
|
icon, %NULL to ignore.</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27178">optional #GCancellable object, %NULL to
|
|
ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_async" c:identifier="g_loadable_icon_load_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27190">Loads an icon asynchronously. To finish this function, see
|
|
g_loadable_icon_load_finish(). For the synchronous, blocking
|
|
version of this function, see g_loadable_icon_load().</doc>
|
|
<source-position filename="gloadableicon.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27192">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27193">an integer.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27194">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27195">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27197">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="load_finish" c:identifier="g_loadable_icon_load_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27205">Finishes an asynchronous icon load started in g_loadable_icon_load_async().</doc>
|
|
<source-position filename="gloadableicon.h" line="92"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27216">a #GInputStream to read the icon from.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27207">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27208">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27209">a location to store the type of the loaded
|
|
icon, %NULL to ignore.</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="LoadableIconIface" c:type="GLoadableIconIface" glib:is-gtype-struct-for="LoadableIcon">
|
|
<doc xml:space="preserve" filename="gloadableicon.h" line="45">Interface for icons that can be loaded as a stream.</doc>
|
|
<source-position filename="gloadableicon.h" line="74"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gloadableicon.h" line="47">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="load">
|
|
<callback name="load" throws="1">
|
|
<source-position filename="gloadableicon.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27186">a #GInputStream to read the icon from.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27174">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27175">an integer.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27176">a location to store the type of the loaded
|
|
icon, %NULL to ignore.</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27178">optional #GCancellable object, %NULL to
|
|
ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="load_async">
|
|
<callback name="load_async">
|
|
<source-position filename="gloadableicon.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27192">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27193">an integer.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27194">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27195">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27197">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="load_finish">
|
|
<callback name="load_finish" throws="1">
|
|
<source-position filename="gloadableicon.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27216">a #GInputStream to read the icon from.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27207">a #GLoadableIcon.</doc>
|
|
<type name="LoadableIcon" c:type="GLoadableIcon*"/>
|
|
</parameter>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27208">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="type" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27209">a location to store the type of the loaded
|
|
icon, %NULL to ignore.</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<function-macro name="MEMORY_INPUT_STREAM" c:identifier="G_MEMORY_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gmemoryinputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MEMORY_INPUT_STREAM_CLASS" c:identifier="G_MEMORY_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gmemoryinputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MEMORY_INPUT_STREAM_GET_CLASS" c:identifier="G_MEMORY_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gmemoryinputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MEMORY_OUTPUT_STREAM" c:identifier="G_MEMORY_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gmemoryoutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MEMORY_OUTPUT_STREAM_CLASS" c:identifier="G_MEMORY_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gmemoryoutputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MEMORY_OUTPUT_STREAM_GET_CLASS" c:identifier="G_MEMORY_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gmemoryoutputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU" c:identifier="G_MENU" introspectable="0">
|
|
<source-position filename="gmenu.h" line="28"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="MENU_ATTRIBUTE_ACTION" value="action" c:type="G_MENU_ATTRIBUTE_ACTION" version="2.32">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="29">The menu item attribute which holds the action name of the item. Action
|
|
names are namespaced with an identifier for the action group in which the
|
|
action resides. For example, "win." for window-specific actions and "app."
|
|
for application-wide actions.
|
|
|
|
See also g_menu_model_get_item_attribute() and g_menu_item_set_attribute().</doc>
|
|
<source-position filename="gmenumodel.h" line="41"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="MENU_ATTRIBUTE_ACTION_NAMESPACE" value="action-namespace" c:type="G_MENU_ATTRIBUTE_ACTION_NAMESPACE" version="2.36">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="43">The menu item attribute that holds the namespace for all action names in
|
|
menus that are linked from this item.</doc>
|
|
<source-position filename="gmenumodel.h" line="51"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="MENU_ATTRIBUTE_ICON" value="icon" c:type="G_MENU_ATTRIBUTE_ICON" version="2.38">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="74">The menu item attribute which holds the icon of the item.
|
|
|
|
The icon is stored in the format returned by g_icon_serialize().
|
|
|
|
This attribute is intended only to represent 'noun' icons such as
|
|
favicons for a webpage, or application icons. It should not be used
|
|
for 'verbs' (ie: stock icons).</doc>
|
|
<source-position filename="gmenumodel.h" line="87"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="MENU_ATTRIBUTE_ITER" c:identifier="G_MENU_ATTRIBUTE_ITER" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="221"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU_ATTRIBUTE_ITER_CLASS" c:identifier="G_MENU_ATTRIBUTE_ITER_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="223"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU_ATTRIBUTE_ITER_GET_CLASS" c:identifier="G_MENU_ATTRIBUTE_ITER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="229"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="MENU_ATTRIBUTE_LABEL" value="label" c:type="G_MENU_ATTRIBUTE_LABEL" version="2.32">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="65">The menu item attribute which holds the label of the item.</doc>
|
|
<source-position filename="gmenumodel.h" line="72"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="MENU_ATTRIBUTE_TARGET" value="target" c:type="G_MENU_ATTRIBUTE_TARGET" version="2.32">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="53">The menu item attribute which holds the target with which the item's action
|
|
will be activated.
|
|
|
|
See also g_menu_item_set_action_and_target()</doc>
|
|
<source-position filename="gmenumodel.h" line="63"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="MENU_ITEM" c:identifier="G_MENU_ITEM" introspectable="0">
|
|
<source-position filename="gmenu.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU_LINK_ITER" c:identifier="G_MENU_LINK_ITER" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="263"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU_LINK_ITER_CLASS" c:identifier="G_MENU_LINK_ITER_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="265"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU_LINK_ITER_GET_CLASS" c:identifier="G_MENU_LINK_ITER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="271"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="MENU_LINK_SECTION" value="section" c:type="G_MENU_LINK_SECTION" version="2.32">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="100">The name of the link that associates a menu item with a section. The linked
|
|
menu will usually be shown in place of the menu item, using the item's label
|
|
as a header.
|
|
|
|
See also g_menu_item_set_link().</doc>
|
|
<source-position filename="gmenumodel.h" line="111"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="MENU_LINK_SUBMENU" value="submenu" c:type="G_MENU_LINK_SUBMENU" version="2.32">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="89">The name of the link that associates a menu item with a submenu.
|
|
|
|
See also g_menu_item_set_link().</doc>
|
|
<source-position filename="gmenumodel.h" line="98"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="MENU_MODEL" c:identifier="G_MENU_MODEL" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="114"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU_MODEL_CLASS" c:identifier="G_MENU_MODEL_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="116"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MENU_MODEL_GET_CLASS" c:identifier="G_MENU_MODEL_GET_CLASS" introspectable="0">
|
|
<source-position filename="gmenumodel.h" line="122"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MOUNT" c:identifier="G_MOUNT" introspectable="0">
|
|
<source-position filename="gmount.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MOUNT_GET_IFACE" c:identifier="G_MOUNT_GET_IFACE" introspectable="0">
|
|
<source-position filename="gmount.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MOUNT_OPERATION" c:identifier="G_MOUNT_OPERATION" introspectable="0">
|
|
<source-position filename="gmountoperation.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MOUNT_OPERATION_CLASS" c:identifier="G_MOUNT_OPERATION_CLASS" introspectable="0">
|
|
<source-position filename="gmountoperation.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="MOUNT_OPERATION_GET_CLASS" c:identifier="G_MOUNT_OPERATION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gmountoperation.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="MemoryInputStream" c:symbol-prefix="memory_input_stream" c:type="GMemoryInputStream" parent="InputStream" glib:type-name="GMemoryInputStream" glib:get-type="g_memory_input_stream_get_type" glib:type-struct="MemoryInputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6856">#GMemoryInputStream is a class for using arbitrary
|
|
memory chunks as input for GIO streaming input operations.
|
|
|
|
As of GLib 2.34, #GMemoryInputStream implements
|
|
#GPollableInputStream.</doc>
|
|
<source-position filename="gmemoryinputstream.h" line="65"/>
|
|
<implements name="PollableInputStream"/>
|
|
<implements name="Seekable"/>
|
|
<constructor name="new" c:identifier="g_memory_input_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27251">Creates a new empty #GMemoryInputStream.</doc>
|
|
<source-position filename="gmemoryinputstream.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27256">a new #GInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<constructor name="new_from_bytes" c:identifier="g_memory_input_stream_new_from_bytes" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27260">Creates a new #GMemoryInputStream with data from the given @bytes.</doc>
|
|
<source-position filename="gmemoryinputstream.h" line="77"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27266">new #GInputStream read from @bytes</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27262">a #GBytes</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_data" c:identifier="g_memory_input_stream_new_from_data">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27271">Creates a new #GMemoryInputStream with data in memory of a given size.</doc>
|
|
<source-position filename="gmemoryinputstream.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27279">new #GInputStream read from @data of @len bytes.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27273">input data</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27274">length of the data, may be -1 if @data is a nul-terminated string</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27275">function that is called to free @data, or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="add_bytes" c:identifier="g_memory_input_stream_add_bytes" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27229">Appends @bytes to data that can be read from the input stream.</doc>
|
|
<source-position filename="gmemoryinputstream.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27231">a #GMemoryInputStream</doc>
|
|
<type name="MemoryInputStream" c:type="GMemoryInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27232">input data</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_data" c:identifier="g_memory_input_stream_add_data">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27240">Appends @data to data that can be read from the input stream</doc>
|
|
<source-position filename="gmemoryinputstream.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27242">a #GMemoryInputStream</doc>
|
|
<type name="MemoryInputStream" c:type="GMemoryInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27243">input data</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27244">length of the data, may be -1 if @data is a nul-terminated string</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27245">function that is called to free @data, or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="InputStream" c:type="GInputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="MemoryInputStreamPrivate" c:type="GMemoryInputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="MemoryInputStreamClass" c:type="GMemoryInputStreamClass" glib:is-gtype-struct-for="MemoryInputStream">
|
|
<source-position filename="gmemoryinputstream.h" line="65"/>
|
|
<field name="parent_class">
|
|
<type name="InputStreamClass" c:type="GInputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gmemoryinputstream.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gmemoryinputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gmemoryinputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gmemoryinputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gmemoryinputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="MemoryInputStreamPrivate" c:type="GMemoryInputStreamPrivate" disguised="1">
|
|
<source-position filename="gmemoryinputstream.h" line="45"/>
|
|
</record>
|
|
<class name="MemoryOutputStream" c:symbol-prefix="memory_output_stream" c:type="GMemoryOutputStream" parent="OutputStream" glib:type-name="GMemoryOutputStream" glib:get-type="g_memory_output_stream_get_type" glib:type-struct="MemoryOutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6870">#GMemoryOutputStream is a class for using arbitrary
|
|
memory chunks as output for GIO streaming output operations.
|
|
|
|
As of GLib 2.34, #GMemoryOutputStream trivially implements
|
|
#GPollableOutputStream: it always polls as ready.</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="66"/>
|
|
<implements name="PollableOutputStream"/>
|
|
<implements name="Seekable"/>
|
|
<constructor name="new" c:identifier="g_memory_output_stream_new" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27333">Creates a new #GMemoryOutputStream.
|
|
|
|
In most cases this is not the function you want. See
|
|
g_memory_output_stream_new_resizable() instead.
|
|
|
|
If @data is non-%NULL, the stream will use that for its internal storage.
|
|
|
|
If @realloc_fn is non-%NULL, it will be used for resizing the internal
|
|
storage when necessary and the stream will be considered resizable.
|
|
In that case, the stream will start out being (conceptually) empty.
|
|
@size is used only as a hint for how big @data is. Specifically,
|
|
seeking to the end of a newly-created stream will seek to zero, not
|
|
@size. Seeking past the end of the stream and then writing will
|
|
introduce a zero-filled gap.
|
|
|
|
If @realloc_fn is %NULL then the stream is fixed-sized. Seeking to
|
|
the end will seek to @size exactly. Writing past the end will give
|
|
an 'out of space' error. Attempting to seek past the end will fail.
|
|
Unlike the resizable case, seeking to an offset within the stream and
|
|
writing will preserve the bytes passed in as @data before that point
|
|
and will return them as part of g_memory_output_stream_steal_data().
|
|
If you intend to seek you should probably therefore ensure that @data
|
|
is properly initialised.
|
|
|
|
It is probably only meaningful to provide @data and @size in the case
|
|
that you want a fixed-sized stream. Put another way: if @realloc_fn
|
|
is non-%NULL then it makes most sense to give @data as %NULL and
|
|
@size as 0 (allowing #GMemoryOutputStream to do the initial
|
|
allocation for itself).
|
|
|
|
|[<!-- language="C" -->
|
|
// a stream that can grow
|
|
stream = g_memory_output_stream_new (NULL, 0, realloc, free);
|
|
|
|
// another stream that can grow
|
|
stream2 = g_memory_output_stream_new (NULL, 0, g_realloc, g_free);
|
|
|
|
// a fixed-size stream
|
|
data = malloc (200);
|
|
stream3 = g_memory_output_stream_new (data, 200, NULL, free);
|
|
]|</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27384">A newly created #GMemoryOutputStream object.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27335">pointer to a chunk of memory to use, or %NULL</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27336">the size of @data</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="realloc_function" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" destroy="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27337">a function with realloc() semantics (like g_realloc())
|
|
to be called when @data needs to be grown, or %NULL</doc>
|
|
<type name="ReallocFunc" c:type="GReallocFunc"/>
|
|
</parameter>
|
|
<parameter name="destroy_function" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27339">a function to be called on @data when the stream is
|
|
finalized, or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_resizable" c:identifier="g_memory_output_stream_new_resizable" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27388">Creates a new #GMemoryOutputStream, using g_realloc() and g_free()
|
|
for memory allocation.</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="92"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="get_data" c:identifier="g_memory_output_stream_get_data">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27283">Gets any loaded data from the @ostream.
|
|
|
|
Note that the returned pointer may become invalid on the next
|
|
write or truncate operation on the stream.</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="94"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27292">pointer to the stream's data, or %NULL if the data
|
|
has been stolen</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="ostream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27285">a #GMemoryOutputStream</doc>
|
|
<type name="MemoryOutputStream" c:type="GMemoryOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_data_size" c:identifier="g_memory_output_stream_get_data_size" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27297">Returns the number of bytes from the start up to including the last
|
|
byte written in the stream that has not been truncated away.</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27304">the number of bytes written to the stream</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="ostream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27299">a #GMemoryOutputStream</doc>
|
|
<type name="MemoryOutputStream" c:type="GMemoryOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_size" c:identifier="g_memory_output_stream_get_size">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27309">Gets the size of the currently allocated data area (available from
|
|
g_memory_output_stream_get_data()).
|
|
|
|
You probably don't want to use this function on resizable streams.
|
|
See g_memory_output_stream_get_data_size() instead. For resizable
|
|
streams the size returned by this function is an implementation
|
|
detail and may be change at any time in response to operations on the
|
|
stream.
|
|
|
|
If the stream is fixed-sized (ie: no realloc was passed to
|
|
g_memory_output_stream_new()) then this is the maximum size of the
|
|
stream and further writes will return %G_IO_ERROR_NO_SPACE.
|
|
|
|
In any case, if you want the number of bytes currently written to the
|
|
stream, use g_memory_output_stream_get_data_size().</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27329">the number of bytes allocated for the data buffer</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="ostream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27311">a #GMemoryOutputStream</doc>
|
|
<type name="MemoryOutputStream" c:type="GMemoryOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="steal_as_bytes" c:identifier="g_memory_output_stream_steal_as_bytes" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27398">Returns data from the @ostream as a #GBytes. @ostream must be
|
|
closed before calling this function.</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="103"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27405">the stream's data</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="ostream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27400">a #GMemoryOutputStream</doc>
|
|
<type name="MemoryOutputStream" c:type="GMemoryOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="steal_data" c:identifier="g_memory_output_stream_steal_data" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27410">Gets any loaded data from the @ostream. Ownership of the data
|
|
is transferred to the caller; when no longer needed it must be
|
|
freed using the free function set in @ostream's
|
|
#GMemoryOutputStream:destroy-function property.
|
|
|
|
@ostream must be closed before calling this function.</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="100"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27421">the stream's data, or %NULL if it has previously
|
|
been stolen</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="ostream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27412">a #GMemoryOutputStream</doc>
|
|
<type name="MemoryOutputStream" c:type="GMemoryOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="data" version="2.24" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2113">Pointer to buffer where data will be written.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</property>
|
|
<property name="data-size" version="2.24" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2122">Size of data written to the buffer.</doc>
|
|
<type name="gulong" c:type="gulong"/>
|
|
</property>
|
|
<property name="destroy-function" version="2.24" introspectable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2131">Function called with the buffer as argument when the stream is destroyed.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</property>
|
|
<property name="realloc-function" version="2.24" introspectable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2140">Function with realloc semantics called to enlarge the buffer.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</property>
|
|
<property name="size" version="2.24" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2149">Current size of the data buffer.</doc>
|
|
<type name="gulong" c:type="gulong"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="OutputStream" c:type="GOutputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="MemoryOutputStreamPrivate" c:type="GMemoryOutputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="MemoryOutputStreamClass" c:type="GMemoryOutputStreamClass" glib:is-gtype-struct-for="MemoryOutputStream">
|
|
<source-position filename="gmemoryoutputstream.h" line="66"/>
|
|
<field name="parent_class">
|
|
<type name="OutputStreamClass" c:type="GOutputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gmemoryoutputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gmemoryoutputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gmemoryoutputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gmemoryoutputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gmemoryoutputstream.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="MemoryOutputStreamPrivate" c:type="GMemoryOutputStreamPrivate" disguised="1">
|
|
<source-position filename="gmemoryoutputstream.h" line="45"/>
|
|
</record>
|
|
<class name="Menu" c:symbol-prefix="menu" c:type="GMenu" version="2.32" parent="MenuModel" glib:type-name="GMenu" glib:get-type="g_menu_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6884">#GMenu is a simple implementation of #GMenuModel.
|
|
You populate a #GMenu by adding #GMenuItem instances to it.
|
|
|
|
There are some convenience functions to allow you to directly
|
|
add items (avoiding #GMenuItem) for the common cases. To add
|
|
a regular item, use g_menu_insert(). To add a section, use
|
|
g_menu_insert_section(). To add a submenu, use
|
|
g_menu_insert_submenu().</doc>
|
|
<constructor name="new" c:identifier="g_menu_new" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28308">Creates a new #GMenu.
|
|
|
|
The new menu has no items.</doc>
|
|
<source-position filename="gmenu.h" line="45"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28315">a new #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="append" c:identifier="g_menu_append" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27441">Convenience function for appending a normal menu item to the end of
|
|
@menu. Combine g_menu_item_new() and g_menu_insert_item() for a more
|
|
flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27443">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27444">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="detailed_action" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27445">the detailed action string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="append_item" c:identifier="g_menu_append_item" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27455">Appends @item to the end of @menu.
|
|
|
|
See g_menu_insert_item() for more information.</doc>
|
|
<source-position filename="gmenu.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27457">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27458">a #GMenuItem to append</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="append_section" c:identifier="g_menu_append_section" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27468">Convenience function for appending a section menu item to the end of
|
|
@menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a
|
|
more flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27470">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27471">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="section" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27472">a #GMenuModel with the items of the section</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="append_submenu" c:identifier="g_menu_append_submenu" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27482">Convenience function for appending a submenu menu item to the end of
|
|
@menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a
|
|
more flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27484">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27485">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="submenu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27486">a #GMenuModel with the items of the submenu</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="freeze" c:identifier="g_menu_freeze" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27570">Marks @menu as frozen.
|
|
|
|
After the menu is frozen, it is an error to attempt to make any
|
|
changes to it. In effect this means that the #GMenu API must no
|
|
longer be used.
|
|
|
|
This function causes g_menu_model_is_mutable() to begin returning
|
|
%FALSE, which has some positive performance implications.</doc>
|
|
<source-position filename="gmenu.h" line="48"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27572">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="insert" c:identifier="g_menu_insert" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27587">Convenience function for inserting a normal menu item into @menu.
|
|
Combine g_menu_item_new() and g_menu_insert_item() for a more flexible
|
|
alternative.</doc>
|
|
<source-position filename="gmenu.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27589">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27590">the position at which to insert the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27591">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="detailed_action" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27592">the detailed action string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="insert_item" c:identifier="g_menu_insert_item" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27602">Inserts @item into @menu.
|
|
|
|
The "insertion" is actually done by copying all of the attribute and
|
|
link values of @item and using them to form a new item within @menu.
|
|
As such, @item itself is not really inserted, but rather, a menu item
|
|
that is exactly the same as the one presently described by @item.
|
|
|
|
This means that @item is essentially useless after the insertion
|
|
occurs. Any changes you make to it are ignored unless it is inserted
|
|
again (at which point its updated values will be copied).
|
|
|
|
You should probably just free @item once you're done.
|
|
|
|
There are many convenience functions to take care of common cases.
|
|
See g_menu_insert(), g_menu_insert_section() and
|
|
g_menu_insert_submenu() as well as "prepend" and "append" variants of
|
|
each of these functions.</doc>
|
|
<source-position filename="gmenu.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27604">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27605">the position at which to insert the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27606">the #GMenuItem to insert</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="insert_section" c:identifier="g_menu_insert_section" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27630">Convenience function for inserting a section menu item into @menu.
|
|
Combine g_menu_item_new_section() and g_menu_insert_item() for a more
|
|
flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27632">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27633">the position at which to insert the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27634">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="section" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27635">a #GMenuModel with the items of the section</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="insert_submenu" c:identifier="g_menu_insert_submenu" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27645">Convenience function for inserting a submenu menu item into @menu.
|
|
Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more
|
|
flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27647">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27648">the position at which to insert the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27649">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="submenu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27650">a #GMenuModel with the items of the submenu</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prepend" c:identifier="g_menu_prepend" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28320">Convenience function for prepending a normal menu item to the start
|
|
of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more
|
|
flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28322">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28323">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="detailed_action" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28324">the detailed action string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prepend_item" c:identifier="g_menu_prepend_item" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28334">Prepends @item to the start of @menu.
|
|
|
|
See g_menu_insert_item() for more information.</doc>
|
|
<source-position filename="gmenu.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28336">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28337">a #GMenuItem to prepend</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prepend_section" c:identifier="g_menu_prepend_section" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28347">Convenience function for prepending a section menu item to the start
|
|
of @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for
|
|
a more flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28349">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28350">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="section" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28351">a #GMenuModel with the items of the section</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prepend_submenu" c:identifier="g_menu_prepend_submenu" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28361">Convenience function for prepending a submenu menu item to the start
|
|
of @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for
|
|
a more flexible alternative.</doc>
|
|
<source-position filename="gmenu.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28363">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28364">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="submenu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28365">a #GMenuModel with the items of the submenu</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove" c:identifier="g_menu_remove" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28375">Removes an item from the menu.
|
|
|
|
@position gives the index of the item to remove.
|
|
|
|
It is an error if position is not in range the range from 0 to one
|
|
less than the number of items in the menu.
|
|
|
|
It is not possible to remove items by identity since items are added
|
|
to the menu simply by copying their links and attributes (ie:
|
|
identity of the item itself is not preserved).</doc>
|
|
<source-position filename="gmenu.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28377">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28378">the position of the item to remove</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove_all" c:identifier="g_menu_remove_all" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28395">Removes all items in the menu.</doc>
|
|
<source-position filename="gmenu.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28397">a #GMenu</doc>
|
|
<type name="Menu" c:type="GMenu*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<class name="MenuAttributeIter" c:symbol-prefix="menu_attribute_iter" c:type="GMenuAttributeIter" version="2.32" parent="GObject.Object" abstract="1" glib:type-name="GMenuAttributeIter" glib:get-type="g_menu_attribute_iter_get_type" glib:type-struct="MenuAttributeIterClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2168">#GMenuAttributeIter is an opaque structure type. You must access it
|
|
using the functions below.</doc>
|
|
<source-position filename="gmenumodel.h" line="245"/>
|
|
<virtual-method name="get_next" invoker="get_next" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27510">This function combines g_menu_attribute_iter_next() with
|
|
g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value().
|
|
|
|
First the iterator is advanced to the next (possibly first) attribute.
|
|
If that fails, then %FALSE is returned and there are no other
|
|
effects.
|
|
|
|
If successful, @name and @value are set to the name and value of the
|
|
attribute that has just been advanced to. At this point,
|
|
g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value() will
|
|
return the same values again.
|
|
|
|
The value returned in @name remains valid for as long as the iterator
|
|
remains at the current position. The value returned in @value must
|
|
be unreffed using g_variant_unref() when it is no longer in use.</doc>
|
|
<source-position filename="gmenumodel.h" line="242"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27532">%TRUE on success, or %FALSE if there is no additional
|
|
attribute</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27512">a #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_name" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27513">the type of the attribute</doc>
|
|
<type name="utf8" c:type="const gchar**"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27514">the attribute value</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_name" c:identifier="g_menu_attribute_iter_get_name" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27496">Gets the name of the attribute at the current iterator position, as
|
|
a string.
|
|
|
|
The iterator is not advanced.</doc>
|
|
<source-position filename="gmenumodel.h" line="257"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27505">the name of the attribute</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27498">a #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_next" c:identifier="g_menu_attribute_iter_get_next" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27510">This function combines g_menu_attribute_iter_next() with
|
|
g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value().
|
|
|
|
First the iterator is advanced to the next (possibly first) attribute.
|
|
If that fails, then %FALSE is returned and there are no other
|
|
effects.
|
|
|
|
If successful, @name and @value are set to the name and value of the
|
|
attribute that has just been advanced to. At this point,
|
|
g_menu_attribute_iter_get_name() and g_menu_attribute_iter_get_value() will
|
|
return the same values again.
|
|
|
|
The value returned in @name remains valid for as long as the iterator
|
|
remains at the current position. The value returned in @value must
|
|
be unreffed using g_variant_unref() when it is no longer in use.</doc>
|
|
<source-position filename="gmenumodel.h" line="251"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27532">%TRUE on success, or %FALSE if there is no additional
|
|
attribute</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27512">a #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_name" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27513">the type of the attribute</doc>
|
|
<type name="utf8" c:type="const gchar**"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27514">the attribute value</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_value" c:identifier="g_menu_attribute_iter_get_value" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27538">Gets the value of the attribute at the current iterator position.
|
|
|
|
The iterator is not advanced.</doc>
|
|
<source-position filename="gmenumodel.h" line="259"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27546">the value of the current attribute</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27540">a #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="next" c:identifier="g_menu_attribute_iter_next" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27551">Attempts to advance the iterator to the next (possibly first)
|
|
attribute.
|
|
|
|
%TRUE is returned on success, or %FALSE if there are no more
|
|
attributes.
|
|
|
|
You must call this function when you first acquire the iterator
|
|
to advance it to the first attribute (and determine if the first
|
|
attribute exists at all).</doc>
|
|
<source-position filename="gmenumodel.h" line="255"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27565">%TRUE on success, or %FALSE when there are no more attributes</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27553">a #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="MenuAttributeIterPrivate" c:type="GMenuAttributeIterPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="MenuAttributeIterClass" c:type="GMenuAttributeIterClass" glib:is-gtype-struct-for="MenuAttributeIter">
|
|
<source-position filename="gmenumodel.h" line="245"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_next">
|
|
<callback name="get_next">
|
|
<source-position filename="gmenumodel.h" line="242"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27532">%TRUE on success, or %FALSE if there is no additional
|
|
attribute</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27512">a #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</parameter>
|
|
<parameter name="out_name" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27513">the type of the attribute</doc>
|
|
<type name="utf8" c:type="const gchar**"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27514">the attribute value</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="MenuAttributeIterPrivate" c:type="GMenuAttributeIterPrivate" disguised="1">
|
|
<source-position filename="gmenumodel.h" line="128"/>
|
|
</record>
|
|
<class name="MenuItem" c:symbol-prefix="menu_item" c:type="GMenuItem" version="2.32" parent="GObject.Object" glib:type-name="GMenuItem" glib:get-type="g_menu_item_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2178">#GMenuItem is an opaque structure type. You must access it using the
|
|
functions below.</doc>
|
|
<constructor name="new" c:identifier="g_menu_item_new" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27712">Creates a new #GMenuItem.
|
|
|
|
If @label is non-%NULL it is used to set the "label" attribute of the
|
|
new item.
|
|
|
|
If @detailed_action is non-%NULL it is used to set the "action" and
|
|
possibly the "target" attribute of the new item. See
|
|
g_menu_item_set_detailed_action() for more information.</doc>
|
|
<source-position filename="gmenu.h" line="113"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27726">a new #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27714">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="detailed_action" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27715">the detailed action string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_model" c:identifier="g_menu_item_new_from_model" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27731">Creates a #GMenuItem as an exact copy of an existing menu item in a
|
|
#GMenuModel.
|
|
|
|
@item_index must be valid (ie: be sure to call
|
|
g_menu_model_get_n_items() first).</doc>
|
|
<source-position filename="gmenu.h" line="117"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27742">a new #GMenuItem.</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27733">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27734">the index of an item in @model</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_section" c:identifier="g_menu_item_new_section" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27747">Creates a new #GMenuItem representing a section.
|
|
|
|
This is a convenience API around g_menu_item_new() and
|
|
g_menu_item_set_section().
|
|
|
|
The effect of having one menu appear as a section of another is
|
|
exactly as it sounds: the items from @section become a direct part of
|
|
the menu that @menu_item is added to.
|
|
|
|
Visual separation is typically displayed between two non-empty
|
|
sections. If @label is non-%NULL then it will be encorporated into
|
|
this visual indication. This allows for labeled subsections of a
|
|
menu.
|
|
|
|
As a simple example, consider a typical "Edit" menu from a simple
|
|
program. It probably contains an "Undo" and "Redo" item, followed by
|
|
a separator, followed by "Cut", "Copy" and "Paste".
|
|
|
|
This would be accomplished by creating three #GMenu instances. The
|
|
first would be populated with the "Undo" and "Redo" items, and the
|
|
second with the "Cut", "Copy" and "Paste" items. The first and
|
|
second menus would then be added as submenus of the third. In XML
|
|
format, this would look something like the following:
|
|
|[
|
|
<menu id='edit-menu'>
|
|
<section>
|
|
<item label='Undo'/>
|
|
<item label='Redo'/>
|
|
</section>
|
|
<section>
|
|
<item label='Cut'/>
|
|
<item label='Copy'/>
|
|
<item label='Paste'/>
|
|
</section>
|
|
</menu>
|
|
]|
|
|
|
|
The following example is exactly equivalent. It is more illustrative
|
|
of the exact relationship between the menus and items (keeping in
|
|
mind that the 'link' element defines a new menu that is linked to the
|
|
containing one). The style of the second example is more verbose and
|
|
difficult to read (and therefore not recommended except for the
|
|
purpose of understanding what is really going on).
|
|
|[
|
|
<menu id='edit-menu'>
|
|
<item>
|
|
<link name='section'>
|
|
<item label='Undo'/>
|
|
<item label='Redo'/>
|
|
</link>
|
|
</item>
|
|
<item>
|
|
<link name='section'>
|
|
<item label='Cut'/>
|
|
<item label='Copy'/>
|
|
<item label='Paste'/>
|
|
</link>
|
|
</item>
|
|
</menu>
|
|
]|</doc>
|
|
<source-position filename="gmenu.h" line="125"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27813">a new #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27749">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="section" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27750">a #GMenuModel with the items of the section</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_submenu" c:identifier="g_menu_item_new_submenu" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27818">Creates a new #GMenuItem representing a submenu.
|
|
|
|
This is a convenience API around g_menu_item_new() and
|
|
g_menu_item_set_submenu().</doc>
|
|
<source-position filename="gmenu.h" line="121"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27828">a new #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27820">the section label, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="submenu" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27821">a #GMenuModel with the items of the submenu</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_attribute" c:identifier="g_menu_item_get_attribute" version="2.34" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27660">Queries the named @attribute on @menu_item.
|
|
|
|
If the attribute exists and matches the #GVariantType corresponding
|
|
to @format_string then @format_string is used to deconstruct the
|
|
value into the positional parameters and %TRUE is returned.
|
|
|
|
If the attribute does not exist, or it does exist but has the wrong
|
|
type, then the positional parameters are ignored and %FALSE is
|
|
returned.</doc>
|
|
<source-position filename="gmenu.h" line="133"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27677">%TRUE if the named attribute was found with the expected
|
|
type</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27662">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27663">the attribute name to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format_string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27664">a #GVariant format string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27665">positional parameters, as per @format_string</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_attribute_value" c:identifier="g_menu_item_get_attribute_value" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27683">Queries the named @attribute on @menu_item.
|
|
|
|
If @expected_type is specified and the attribute does not have this
|
|
type, %NULL is returned. %NULL is also returned if the attribute
|
|
simply does not exist.</doc>
|
|
<source-position filename="gmenu.h" line="129"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27695">the attribute value, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27685">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27686">the attribute name to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27687">the expected type of the attribute</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_link" c:identifier="g_menu_item_get_link" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27700">Queries the named @link on @menu_item.</doc>
|
|
<source-position filename="gmenu.h" line="138"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27707">the link, or %NULL</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27702">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="link" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27703">the link name to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_action_and_target" c:identifier="g_menu_item_set_action_and_target" version="2.32" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27833">Sets or unsets the "action" and "target" attributes of @menu_item.
|
|
|
|
If @action is %NULL then both the "action" and "target" attributes
|
|
are unset (and @format_string is ignored along with the positional
|
|
parameters).
|
|
|
|
If @action is non-%NULL then the "action" attribute is set.
|
|
@format_string is then inspected. If it is non-%NULL then the proper
|
|
position parameters are collected to create a #GVariant instance to
|
|
use as the target value. If it is %NULL then the positional
|
|
parameters are ignored and the "target" attribute is unset.
|
|
|
|
See also g_menu_item_set_action_and_target_value() for an equivalent
|
|
call that directly accepts a #GVariant. See
|
|
g_menu_item_set_detailed_action() for a more convenient version that
|
|
works with string-typed targets.
|
|
|
|
See also g_menu_item_set_action_and_target_value() for a
|
|
description of the semantics of the action and target attributes.</doc>
|
|
<source-position filename="gmenu.h" line="168"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27835">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="action" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27836">the name of the action for this item</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format_string" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27837">a GVariant format string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27838">positional parameters, as per @format_string</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_action_and_target_value" c:identifier="g_menu_item_set_action_and_target_value" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27864">Sets or unsets the "action" and "target" attributes of @menu_item.
|
|
|
|
If @action is %NULL then both the "action" and "target" attributes
|
|
are unset (and @target_value is ignored).
|
|
|
|
If @action is non-%NULL then the "action" attribute is set. The
|
|
"target" attribute is then set to the value of @target_value if it is
|
|
non-%NULL or unset otherwise.
|
|
|
|
Normal menu items (ie: not submenu, section or other custom item
|
|
types) are expected to have the "action" attribute set to identify
|
|
the action that they are associated with. The state type of the
|
|
action help to determine the disposition of the menu item. See
|
|
#GAction and #GActionGroup for an overview of actions.
|
|
|
|
In general, clicking on the menu item will result in activation of
|
|
the named action with the "target" attribute given as the parameter
|
|
to the action invocation. If the "target" attribute is not set then
|
|
the action is invoked with no parameter.
|
|
|
|
If the action has no state then the menu item is usually drawn as a
|
|
plain menu item (ie: with no additional decoration).
|
|
|
|
If the action has a boolean state then the menu item is usually drawn
|
|
as a toggle menu item (ie: with a checkmark or equivalent
|
|
indication). The item should be marked as 'toggled' or 'checked'
|
|
when the boolean state is %TRUE.
|
|
|
|
If the action has a string state then the menu item is usually drawn
|
|
as a radio menu item (ie: with a radio bullet or equivalent
|
|
indication). The item should be marked as 'selected' when the string
|
|
state is equal to the value of the @target property.
|
|
|
|
See g_menu_item_set_action_and_target() or
|
|
g_menu_item_set_detailed_action() for two equivalent calls that are
|
|
probably more convenient for most uses.</doc>
|
|
<source-position filename="gmenu.h" line="164"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27866">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="action" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27867">the name of the action for this item</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="target_value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27868">a #GVariant to use as the action target</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute" c:identifier="g_menu_item_set_attribute" version="2.32" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27911">Sets or unsets an attribute on @menu_item.
|
|
|
|
The attribute to set or unset is specified by @attribute. This
|
|
can be one of the standard attribute names %G_MENU_ATTRIBUTE_LABEL,
|
|
%G_MENU_ATTRIBUTE_ACTION, %G_MENU_ATTRIBUTE_TARGET, or a custom
|
|
attribute name.
|
|
Attribute names are restricted to lowercase characters, numbers
|
|
and '-'. Furthermore, the names must begin with a lowercase character,
|
|
must not end with a '-', and must not contain consecutive dashes.
|
|
|
|
If @format_string is non-%NULL then the proper position parameters
|
|
are collected to create a #GVariant instance to use as the attribute
|
|
value. If it is %NULL then the positional parameterrs are ignored
|
|
and the named attribute is unset.
|
|
|
|
See also g_menu_item_set_attribute_value() for an equivalent call
|
|
that directly accepts a #GVariant.</doc>
|
|
<source-position filename="gmenu.h" line="146"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27913">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27914">the attribute to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format_string" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27915">a #GVariant format string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27916">positional parameters, as per @format_string</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_attribute_value" c:identifier="g_menu_item_set_attribute_value" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27940">Sets or unsets an attribute on @menu_item.
|
|
|
|
The attribute to set or unset is specified by @attribute. This
|
|
can be one of the standard attribute names %G_MENU_ATTRIBUTE_LABEL,
|
|
%G_MENU_ATTRIBUTE_ACTION, %G_MENU_ATTRIBUTE_TARGET, or a custom
|
|
attribute name.
|
|
Attribute names are restricted to lowercase characters, numbers
|
|
and '-'. Furthermore, the names must begin with a lowercase character,
|
|
must not end with a '-', and must not contain consecutive dashes.
|
|
|
|
must consist only of lowercase
|
|
ASCII characters, digits and '-'.
|
|
|
|
If @value is non-%NULL then it is used as the new value for the
|
|
attribute. If @value is %NULL then the attribute is unset. If
|
|
the @value #GVariant is floating, it is consumed.
|
|
|
|
See also g_menu_item_set_attribute() for a more convenient way to do
|
|
the same.</doc>
|
|
<source-position filename="gmenu.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27942">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27943">the attribute to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27944">a #GVariant to use as the value, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_detailed_action" c:identifier="g_menu_item_set_detailed_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27970">Sets the "action" and possibly the "target" attribute of @menu_item.
|
|
|
|
The format of @detailed_action is the same format parsed by
|
|
g_action_parse_detailed_name().
|
|
|
|
See g_menu_item_set_action_and_target() or
|
|
g_menu_item_set_action_and_target_value() for more flexible (but
|
|
slightly less convenient) alternatives.
|
|
|
|
See also g_menu_item_set_action_and_target_value() for a description of
|
|
the semantics of the action and target attributes.</doc>
|
|
<source-position filename="gmenu.h" line="173"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27972">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="detailed_action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27973">the "detailed" action string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_icon" c:identifier="g_menu_item_set_icon" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27991">Sets (or unsets) the icon on @menu_item.
|
|
|
|
This call is the same as calling g_icon_serialize() and using the
|
|
result as the value to g_menu_item_set_attribute_value() for
|
|
%G_MENU_ATTRIBUTE_ICON.
|
|
|
|
This API is only intended for use with "noun" menu items; things like
|
|
bookmarks or applications in an "Open With" menu. Don't use it on
|
|
menu items corresponding to verbs (eg: stock icons for 'Save' or
|
|
'Quit').
|
|
|
|
If @icon is %NULL then the icon is unset.</doc>
|
|
<source-position filename="gmenu.h" line="177"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27993">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27994">a #GIcon, or %NULL</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_label" c:identifier="g_menu_item_set_label" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28013">Sets or unsets the "label" attribute of @menu_item.
|
|
|
|
If @label is non-%NULL it is used as the label for the menu item. If
|
|
it is %NULL then the label attribute is unset.</doc>
|
|
<source-position filename="gmenu.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28015">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28016">the label to set, or %NULL to unset</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_link" c:identifier="g_menu_item_set_link" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28027">Creates a link from @menu_item to @model if non-%NULL, or unsets it.
|
|
|
|
Links are used to establish a relationship between a particular menu
|
|
item and another menu. For example, %G_MENU_LINK_SUBMENU is used to
|
|
associate a submenu with a particular menu item, and %G_MENU_LINK_SECTION
|
|
is used to create a section. Other types of link can be used, but there
|
|
is no guarantee that clients will be able to make sense of them.
|
|
Link types are restricted to lowercase characters, numbers
|
|
and '-'. Furthermore, the names must begin with a lowercase character,
|
|
must not end with a '-', and must not contain consecutive dashes.</doc>
|
|
<source-position filename="gmenu.h" line="151"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28029">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="link" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28030">type of link to establish or unset</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="model" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28031">the #GMenuModel to link to (or %NULL to unset)</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_section" c:identifier="g_menu_item_set_section" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28048">Sets or unsets the "section" link of @menu_item to @section.
|
|
|
|
The effect of having one menu appear as a section of another is
|
|
exactly as it sounds: the items from @section become a direct part of
|
|
the menu that @menu_item is added to. See g_menu_item_new_section()
|
|
for more information about what it means for a menu item to be a
|
|
section.</doc>
|
|
<source-position filename="gmenu.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28050">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="section" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28051">a #GMenuModel, or %NULL</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_submenu" c:identifier="g_menu_item_set_submenu" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28065">Sets or unsets the "submenu" link of @menu_item to @submenu.
|
|
|
|
If @submenu is non-%NULL, it is linked to. If it is %NULL then the
|
|
link is unset.
|
|
|
|
The effect of having one menu appear as a submenu of another is
|
|
exactly as it sounds.</doc>
|
|
<source-position filename="gmenu.h" line="158"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="menu_item" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28067">a #GMenuItem</doc>
|
|
<type name="MenuItem" c:type="GMenuItem*"/>
|
|
</instance-parameter>
|
|
<parameter name="submenu" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28068">a #GMenuModel, or %NULL</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<class name="MenuLinkIter" c:symbol-prefix="menu_link_iter" c:type="GMenuLinkIter" version="2.32" parent="GObject.Object" abstract="1" glib:type-name="GMenuLinkIter" glib:get-type="g_menu_link_iter_get_type" glib:type-struct="MenuLinkIterClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2188">#GMenuLinkIter is an opaque structure type. You must access it using
|
|
the functions below.</doc>
|
|
<source-position filename="gmenumodel.h" line="287"/>
|
|
<virtual-method name="get_next" invoker="get_next" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28095">This function combines g_menu_link_iter_next() with
|
|
g_menu_link_iter_get_name() and g_menu_link_iter_get_value().
|
|
|
|
First the iterator is advanced to the next (possibly first) link.
|
|
If that fails, then %FALSE is returned and there are no other effects.
|
|
|
|
If successful, @out_link and @value are set to the name and #GMenuModel
|
|
of the link that has just been advanced to. At this point,
|
|
g_menu_link_iter_get_name() and g_menu_link_iter_get_value() will return the
|
|
same values again.
|
|
|
|
The value returned in @out_link remains valid for as long as the iterator
|
|
remains at the current position. The value returned in @value must
|
|
be unreffed using g_object_unref() when it is no longer in use.</doc>
|
|
<source-position filename="gmenumodel.h" line="284"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28116">%TRUE on success, or %FALSE if there is no additional link</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28097">a #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_link" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28098">the name of the link</doc>
|
|
<type name="utf8" c:type="const gchar**"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28099">the linked #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_name" c:identifier="g_menu_link_iter_get_name" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28082">Gets the name of the link at the current iterator position.
|
|
|
|
The iterator is not advanced.</doc>
|
|
<source-position filename="gmenumodel.h" line="299"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28090">the type of the link</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28084">a #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_next" c:identifier="g_menu_link_iter_get_next" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28095">This function combines g_menu_link_iter_next() with
|
|
g_menu_link_iter_get_name() and g_menu_link_iter_get_value().
|
|
|
|
First the iterator is advanced to the next (possibly first) link.
|
|
If that fails, then %FALSE is returned and there are no other effects.
|
|
|
|
If successful, @out_link and @value are set to the name and #GMenuModel
|
|
of the link that has just been advanced to. At this point,
|
|
g_menu_link_iter_get_name() and g_menu_link_iter_get_value() will return the
|
|
same values again.
|
|
|
|
The value returned in @out_link remains valid for as long as the iterator
|
|
remains at the current position. The value returned in @value must
|
|
be unreffed using g_object_unref() when it is no longer in use.</doc>
|
|
<source-position filename="gmenumodel.h" line="293"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28116">%TRUE on success, or %FALSE if there is no additional link</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28097">a #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</instance-parameter>
|
|
<parameter name="out_link" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28098">the name of the link</doc>
|
|
<type name="utf8" c:type="const gchar**"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28099">the linked #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_value" c:identifier="g_menu_link_iter_get_value" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28121">Gets the linked #GMenuModel at the current iterator position.
|
|
|
|
The iterator is not advanced.</doc>
|
|
<source-position filename="gmenumodel.h" line="301"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28129">the #GMenuModel that is linked to</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28123">a #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="next" c:identifier="g_menu_link_iter_next" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28134">Attempts to advance the iterator to the next (possibly first)
|
|
link.
|
|
|
|
%TRUE is returned on success, or %FALSE if there are no more links.
|
|
|
|
You must call this function when you first acquire the iterator to
|
|
advance it to the first link (and determine if the first link exists
|
|
at all).</doc>
|
|
<source-position filename="gmenumodel.h" line="297"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28147">%TRUE on success, or %FALSE when there are no more links</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28136">a #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="MenuLinkIterPrivate" c:type="GMenuLinkIterPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="MenuLinkIterClass" c:type="GMenuLinkIterClass" glib:is-gtype-struct-for="MenuLinkIter">
|
|
<source-position filename="gmenumodel.h" line="287"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_next">
|
|
<callback name="get_next">
|
|
<source-position filename="gmenumodel.h" line="284"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28116">%TRUE on success, or %FALSE if there is no additional link</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="iter" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28097">a #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</parameter>
|
|
<parameter name="out_link" direction="out" caller-allocates="0" transfer-ownership="none" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28098">the name of the link</doc>
|
|
<type name="utf8" c:type="const gchar**"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28099">the linked #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="MenuLinkIterPrivate" c:type="GMenuLinkIterPrivate" disguised="1">
|
|
<source-position filename="gmenumodel.h" line="132"/>
|
|
</record>
|
|
<class name="MenuModel" c:symbol-prefix="menu_model" c:type="GMenuModel" version="2.32" parent="GObject.Object" abstract="1" glib:type-name="GMenuModel" glib:get-type="g_menu_model_get_type" glib:type-struct="MenuModelClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="6917">#GMenuModel represents the contents of a menu -- an ordered list of
|
|
menu items. The items are associated with actions, which can be
|
|
activated through them. Items can be grouped in sections, and may
|
|
have submenus associated with them. Both items and sections usually
|
|
have some representation data, such as labels or icons. The type of
|
|
the associated action (ie whether it is stateful, and what kind of
|
|
state it has) can influence the representation of the item.
|
|
|
|
The conceptual model of menus in #GMenuModel is hierarchical:
|
|
sections and submenus are again represented by #GMenuModels.
|
|
Menus themselves do not define their own roles. Rather, the role
|
|
of a particular #GMenuModel is defined by the item that references
|
|
it (or, in the case of the 'root' menu, is defined by the context
|
|
in which it is used).
|
|
|
|
As an example, consider the visible portions of this menu:
|
|
|
|
## An example menu # {#menu-example}
|
|
|
|
|
|
|
|
There are 8 "menus" visible in the screenshot: one menubar, two
|
|
submenus and 5 sections:
|
|
|
|
- the toplevel menubar (containing 4 items)
|
|
- the View submenu (containing 3 sections)
|
|
- the first section of the View submenu (containing 2 items)
|
|
- the second section of the View submenu (containing 1 item)
|
|
- the final section of the View submenu (containing 1 item)
|
|
- the Highlight Mode submenu (containing 2 sections)
|
|
- the Sources section (containing 2 items)
|
|
- the Markup section (containing 2 items)
|
|
|
|
The [example][menu-model] illustrates the conceptual connection between
|
|
these 8 menus. Each large block in the figure represents a menu and the
|
|
smaller blocks within the large block represent items in that menu. Some
|
|
items contain references to other menus.
|
|
|
|
## A menu example # {#menu-model}
|
|
|
|
|
|
|
|
Notice that the separators visible in the [example][menu-example]
|
|
appear nowhere in the [menu model][menu-model]. This is because
|
|
separators are not explicitly represented in the menu model. Instead,
|
|
a separator is inserted between any two non-empty sections of a menu.
|
|
Section items can have labels just like any other item. In that case,
|
|
a display system may show a section header instead of a separator.
|
|
|
|
The motivation for this abstract model of application controls is
|
|
that modern user interfaces tend to make these controls available
|
|
outside the application. Examples include global menus, jumplists,
|
|
dash boards, etc. To support such uses, it is necessary to 'export'
|
|
information about actions and their representation in menus, which
|
|
is exactly what the [GActionGroup exporter][gio-GActionGroup-exporter]
|
|
and the [GMenuModel exporter][gio-GMenuModel-exporter] do for
|
|
#GActionGroup and #GMenuModel. The client-side counterparts to
|
|
make use of the exported information are #GDBusActionGroup and
|
|
#GDBusMenuModel.
|
|
|
|
The API of #GMenuModel is very generic, with iterators for the
|
|
attributes and links of an item, see g_menu_model_iterate_item_attributes()
|
|
and g_menu_model_iterate_item_links(). The 'standard' attributes and
|
|
link types have predefined names: %G_MENU_ATTRIBUTE_LABEL,
|
|
%G_MENU_ATTRIBUTE_ACTION, %G_MENU_ATTRIBUTE_TARGET, %G_MENU_LINK_SECTION
|
|
and %G_MENU_LINK_SUBMENU.
|
|
|
|
Items in a #GMenuModel represent active controls if they refer to
|
|
an action that can get activated when the user interacts with the
|
|
menu item. The reference to the action is encoded by the string id
|
|
in the %G_MENU_ATTRIBUTE_ACTION attribute. An action id uniquely
|
|
identifies an action in an action group. Which action group(s) provide
|
|
actions depends on the context in which the menu model is used.
|
|
E.g. when the model is exported as the application menu of a
|
|
#GtkApplication, actions can be application-wide or window-specific
|
|
(and thus come from two different action groups). By convention, the
|
|
application-wide actions have names that start with "app.", while the
|
|
names of window-specific actions start with "win.".
|
|
|
|
While a wide variety of stateful actions is possible, the following
|
|
is the minimum that is expected to be supported by all users of exported
|
|
menu information:
|
|
- an action with no parameter type and no state
|
|
- an action with no parameter type and boolean state
|
|
- an action with string parameter type and string state
|
|
|
|
## Stateless
|
|
|
|
A stateless action typically corresponds to an ordinary menu item.
|
|
|
|
Selecting such a menu item will activate the action (with no parameter).
|
|
|
|
## Boolean State
|
|
|
|
An action with a boolean state will most typically be used with a "toggle"
|
|
or "switch" menu item. The state can be set directly, but activating the
|
|
action (with no parameter) results in the state being toggled.
|
|
|
|
Selecting a toggle menu item will activate the action. The menu item should
|
|
be rendered as "checked" when the state is true.
|
|
|
|
## String Parameter and State
|
|
|
|
Actions with string parameters and state will most typically be used to
|
|
represent an enumerated choice over the items available for a group of
|
|
radio menu items. Activating the action with a string parameter is
|
|
equivalent to setting that parameter as the state.
|
|
|
|
Radio menu items, in addition to being associated with the action, will
|
|
have a target value. Selecting that menu item will result in activation
|
|
of the action with the target value as the parameter. The menu item should
|
|
be rendered as "selected" when the state of the action is equal to the
|
|
target value of the menu item.</doc>
|
|
<source-position filename="gmenumodel.h" line="181"/>
|
|
<virtual-method name="get_item_attribute_value" invoker="get_item_attribute_value" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28183">Queries the item at position @item_index in @model for the attribute
|
|
specified by @attribute.
|
|
|
|
If @expected_type is non-%NULL then it specifies the expected type of
|
|
the attribute. If it is %NULL then any type will be accepted.
|
|
|
|
If the attribute exists and matches @expected_type (or if the
|
|
expected type is unspecified) then the value is returned.
|
|
|
|
If the attribute does not exist, or does not match the expected type
|
|
then %NULL is returned.</doc>
|
|
<source-position filename="gmenumodel.h" line="169"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28203">the value of the attribute</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28185">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28186">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28187">the attribute to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28188">the expected type of the attribute, or
|
|
%NULL</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_item_attributes">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="142">Gets all the attributes associated with the item in the menu model.</doc>
|
|
<source-position filename="gmenumodel.h" line="164"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="144">the #GMenuModel to query</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="145">The #GMenuItem to query</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="attributes" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="146">Attributes on the item</doc>
|
|
<type name="GLib.HashTable" c:type="GHashTable**">
|
|
<type name="utf8"/>
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_item_link" invoker="get_item_link" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28208">Queries the item at position @item_index in @model for the link
|
|
specified by @link.
|
|
|
|
If the link exists, the linked #GMenuModel is returned. If the link
|
|
does not exist, %NULL is returned.</doc>
|
|
<source-position filename="gmenumodel.h" line="178"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28220">the linked #GMenuModel, or %NULL</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28210">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28211">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="link" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28212">the link to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_item_links">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="150">Gets all the links associated with the item in the menu model.</doc>
|
|
<source-position filename="gmenumodel.h" line="173"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="152">the #GMenuModel to query</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="153">The #GMenuItem to query</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="links" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="154">Links from the item</doc>
|
|
<type name="GLib.HashTable" c:type="GHashTable**">
|
|
<type name="utf8"/>
|
|
<type name="MenuModel"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_n_items" invoker="get_n_items" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28225">Query the number of items in @model.</doc>
|
|
<source-position filename="gmenumodel.h" line="163"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28231">the number of items</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28227">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_mutable" invoker="is_mutable" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28236">Queries if @model is mutable.
|
|
|
|
An immutable #GMenuModel will never emit the #GMenuModel::items-changed
|
|
signal. Consumers of the model may make optimisations accordingly.</doc>
|
|
<source-position filename="gmenumodel.h" line="162"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28245">%TRUE if the model is mutable (ie: "items-changed" may be
|
|
emitted).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28238">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="iterate_item_attributes" invoker="iterate_item_attributes" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28278">Creates a #GMenuAttributeIter to iterate over the attributes of
|
|
the item at position @item_index in @model.
|
|
|
|
You must free the iterator with g_object_unref() when you are done.</doc>
|
|
<source-position filename="gmenumodel.h" line="167"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28288">a new #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28280">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28281">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="iterate_item_links" invoker="iterate_item_links" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28293">Creates a #GMenuLinkIter to iterate over the links of the item at
|
|
position @item_index in @model.
|
|
|
|
You must free the iterator with g_object_unref() when you are done.</doc>
|
|
<source-position filename="gmenumodel.h" line="176"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28303">a new #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28295">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28296">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_item_attribute" c:identifier="g_menu_model_get_item_attribute" version="2.32" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28152">Queries item at position @item_index in @model for the attribute
|
|
specified by @attribute.
|
|
|
|
If the attribute exists and matches the #GVariantType corresponding
|
|
to @format_string then @format_string is used to deconstruct the
|
|
value into the positional parameters and %TRUE is returned.
|
|
|
|
If the attribute does not exist, or it does exist but has the wrong
|
|
type, then the positional parameters are ignored and %FALSE is
|
|
returned.
|
|
|
|
This function is a mix of g_menu_model_get_item_attribute_value() and
|
|
g_variant_get(), followed by a g_variant_unref(). As such,
|
|
@format_string must make a complete copy of the data (since the
|
|
#GVariant may go away after the call to g_variant_unref()). In
|
|
particular, no '&' characters are allowed in @format_string.</doc>
|
|
<source-position filename="gmenumodel.h" line="200"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28177">%TRUE if the named attribute was found with the expected
|
|
type</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28154">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28155">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28156">the attribute to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format_string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28157">a #GVariant format string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28158">positional parameters, as per @format_string</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_item_attribute_value" c:identifier="g_menu_model_get_item_attribute_value" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28183">Queries the item at position @item_index in @model for the attribute
|
|
specified by @attribute.
|
|
|
|
If @expected_type is non-%NULL then it specifies the expected type of
|
|
the attribute. If it is %NULL then any type will be accepted.
|
|
|
|
If the attribute exists and matches @expected_type (or if the
|
|
expected type is unspecified) then the value is returned.
|
|
|
|
If the attribute does not exist, or does not match the expected type
|
|
then %NULL is returned.</doc>
|
|
<source-position filename="gmenumodel.h" line="195"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28203">the value of the attribute</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28185">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28186">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28187">the attribute to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28188">the expected type of the attribute, or
|
|
%NULL</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_item_link" c:identifier="g_menu_model_get_item_link" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28208">Queries the item at position @item_index in @model for the link
|
|
specified by @link.
|
|
|
|
If the link exists, the linked #GMenuModel is returned. If the link
|
|
does not exist, %NULL is returned.</doc>
|
|
<source-position filename="gmenumodel.h" line="209"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28220">the linked #GMenuModel, or %NULL</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28210">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28211">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="link" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28212">the link to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_n_items" c:identifier="g_menu_model_get_n_items" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28225">Query the number of items in @model.</doc>
|
|
<source-position filename="gmenumodel.h" line="189"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28231">the number of items</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28227">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_mutable" c:identifier="g_menu_model_is_mutable" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28236">Queries if @model is mutable.
|
|
|
|
An immutable #GMenuModel will never emit the #GMenuModel::items-changed
|
|
signal. Consumers of the model may make optimisations accordingly.</doc>
|
|
<source-position filename="gmenumodel.h" line="187"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28245">%TRUE if the model is mutable (ie: "items-changed" may be
|
|
emitted).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28238">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="items_changed" c:identifier="g_menu_model_items_changed" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28251">Requests emission of the #GMenuModel::items-changed signal on @model.
|
|
|
|
This function should never be called except by #GMenuModel
|
|
subclasses. Any other calls to this function will very likely lead
|
|
to a violation of the interface of the model.
|
|
|
|
The implementation should update its internal representation of the
|
|
menu before emitting the signal. The implementation should further
|
|
expect to receive queries about the new state of the menu (and
|
|
particularly added menu items) while signal handlers are running.
|
|
|
|
The implementation must dispatch this call directly from a mainloop
|
|
entry and not in response to calls -- particularly those from the
|
|
#GMenuModel API. Said another way: the menu must not change while
|
|
user code is running without returning to the mainloop.</doc>
|
|
<source-position filename="gmenumodel.h" line="214"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28253">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28254">the position of the change</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="removed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28255">the number of items removed</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="added" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28256">the number of items added</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="iterate_item_attributes" c:identifier="g_menu_model_iterate_item_attributes" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28278">Creates a #GMenuAttributeIter to iterate over the attributes of
|
|
the item at position @item_index in @model.
|
|
|
|
You must free the iterator with g_object_unref() when you are done.</doc>
|
|
<source-position filename="gmenumodel.h" line="192"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28288">a new #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28280">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28281">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="iterate_item_links" c:identifier="g_menu_model_iterate_item_links" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28293">Creates a #GMenuLinkIter to iterate over the links of the item at
|
|
position @item_index in @model.
|
|
|
|
You must free the iterator with g_object_unref() when you are done.</doc>
|
|
<source-position filename="gmenumodel.h" line="206"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28303">a new #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28295">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</instance-parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28296">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="MenuModelPrivate" c:type="GMenuModelPrivate*"/>
|
|
</field>
|
|
<glib:signal name="items-changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2208">Emitted when a change has occured to the menu.
|
|
|
|
The only changes that can occur to a menu is that items are removed
|
|
or added. Items may not change (except by being removed and added
|
|
back in the same location). This signal is capable of describing
|
|
both of those changes (at the same time).
|
|
|
|
The signal means that starting at the index @position, @removed
|
|
items were removed and @added items were added in their place. If
|
|
@removed is zero then only items were added. If @added is zero
|
|
then only items were removed.
|
|
|
|
As an example, if the menu contains items a, b, c, d (in that
|
|
order) and the signal (2, 1, 3) occurs then the new composition of
|
|
the menu will be a, b, _, _, _, d (with each _ representing some
|
|
new item).
|
|
|
|
Signal handlers may query the model (particularly the added items)
|
|
and expect to see the results of the modification that is being
|
|
reported. The signal is emitted after the modification.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="position" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2211">the position of the change</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="removed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2212">the number of items removed</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="added" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2213">the number of items added</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="MenuModelClass" c:type="GMenuModelClass" glib:is-gtype-struct-for="MenuModel">
|
|
<source-position filename="gmenumodel.h" line="181"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="is_mutable">
|
|
<callback name="is_mutable">
|
|
<source-position filename="gmenumodel.h" line="162"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28245">%TRUE if the model is mutable (ie: "items-changed" may be
|
|
emitted).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28238">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_n_items">
|
|
<callback name="get_n_items">
|
|
<source-position filename="gmenumodel.h" line="163"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28231">the number of items</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28227">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_item_attributes">
|
|
<callback name="get_item_attributes">
|
|
<source-position filename="gmenumodel.h" line="164"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="144">the #GMenuModel to query</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="145">The #GMenuItem to query</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="attributes" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="146">Attributes on the item</doc>
|
|
<type name="GLib.HashTable" c:type="GHashTable**">
|
|
<type name="utf8"/>
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="iterate_item_attributes">
|
|
<callback name="iterate_item_attributes">
|
|
<source-position filename="gmenumodel.h" line="167"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28288">a new #GMenuAttributeIter</doc>
|
|
<type name="MenuAttributeIter" c:type="GMenuAttributeIter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28280">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28281">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_item_attribute_value">
|
|
<callback name="get_item_attribute_value">
|
|
<source-position filename="gmenumodel.h" line="169"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28203">the value of the attribute</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28185">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28186">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="attribute" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28187">the attribute to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28188">the expected type of the attribute, or
|
|
%NULL</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_item_links">
|
|
<callback name="get_item_links">
|
|
<source-position filename="gmenumodel.h" line="173"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="152">the #GMenuModel to query</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="153">The #GMenuItem to query</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="links" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gmenumodel.h" line="154">Links from the item</doc>
|
|
<type name="GLib.HashTable" c:type="GHashTable**">
|
|
<type name="utf8"/>
|
|
<type name="MenuModel"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="iterate_item_links">
|
|
<callback name="iterate_item_links">
|
|
<source-position filename="gmenumodel.h" line="176"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28303">a new #GMenuLinkIter</doc>
|
|
<type name="MenuLinkIter" c:type="GMenuLinkIter*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28295">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28296">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_item_link">
|
|
<callback name="get_item_link">
|
|
<source-position filename="gmenumodel.h" line="178"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28220">the linked #GMenuModel, or %NULL</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="model" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28210">a #GMenuModel</doc>
|
|
<type name="MenuModel" c:type="GMenuModel*"/>
|
|
</parameter>
|
|
<parameter name="item_index" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28211">the index of the item</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="link" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28212">the link to query</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="MenuModelPrivate" c:type="GMenuModelPrivate" disguised="1">
|
|
<source-position filename="gmenumodel.h" line="125"/>
|
|
</record>
|
|
<interface name="Mount" c:symbol-prefix="mount" c:type="GMount" glib:type-name="GMount" glib:get-type="g_mount_get_type" glib:type-struct="MountIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7040">The #GMount interface represents user-visible mounts. Note, when
|
|
porting from GnomeVFS, #GMount is the moral equivalent of #GnomeVFSVolume.
|
|
|
|
#GMount is a "mounted" filesystem that you can access. Mounted is in
|
|
quotes because it's not the same as a unix mount, it might be a gvfs
|
|
mount, but you can still access the files on it if you use GIO. Might or
|
|
might not be related to a volume object.
|
|
|
|
Unmounting a #GMount instance is an asynchronous operation. For
|
|
more information about asynchronous operations, see #GAsyncResult
|
|
and #GTask. To unmount a #GMount instance, first call
|
|
g_mount_unmount_with_operation() with (at least) the #GMount instance and a
|
|
#GAsyncReadyCallback. The callback will be fired when the
|
|
operation has resolved (either with success or failure), and a
|
|
#GAsyncResult structure will be passed to the callback. That
|
|
callback should then call g_mount_unmount_with_operation_finish() with the #GMount
|
|
and the #GAsyncResult data to see if the operation was completed
|
|
successfully. If an @error is present when g_mount_unmount_with_operation_finish()
|
|
is called, then it will be filled with any error information.</doc>
|
|
<source-position filename="gmount.h" line="162"/>
|
|
<virtual-method name="can_eject" invoker="can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28405">Checks if @mount can be ejected.</doc>
|
|
<source-position filename="gmount.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28411">%TRUE if the @mount can be ejected.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28407">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_unmount" invoker="can_unmount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28415">Checks if @mount can be unmounted.</doc>
|
|
<source-position filename="gmount.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28421">%TRUE if the @mount can be unmounted.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28417">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="changed">
|
|
<source-position filename="gmount.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject" invoker="eject" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28425">Ejects a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_eject_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_eject_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28427">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28428">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28429">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28430">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28431">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_finish" invoker="eject_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28441">Finishes ejecting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_eject_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28451">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28443">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28444">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_with_operation" invoker="eject_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28456">Ejects a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_eject_with_operation_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gmount.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28458">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28459">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28460">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28462">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28463">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28464">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_with_operation_finish" invoker="eject_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28474">Finishes ejecting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gmount.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28484">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28476">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28477">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_default_location" invoker="get_default_location">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28489">Gets the default location of @mount. The default location of the given
|
|
@mount is a path that reflects the main entry point for the user (e.g.
|
|
the home directory, or the root of the volume).</doc>
|
|
<source-position filename="gmount.h" line="158"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28497">a #GFile.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28491">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_drive" invoker="get_drive">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28503">Gets the drive for the @mount.
|
|
|
|
This is a convenience method for getting the #GVolume and then
|
|
using that object to get the #GDrive.</doc>
|
|
<source-position filename="gmount.h" line="91"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28512">a #GDrive or %NULL if @mount is not
|
|
associated with a volume or a drive.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28505">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_icon" invoker="get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28519">Gets the icon for @mount.</doc>
|
|
<source-position filename="gmount.h" line="88"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28525">a #GIcon.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28521">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_name" invoker="get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28531">Gets the name of @mount.</doc>
|
|
<source-position filename="gmount.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28537">the name for the given @mount.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28533">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_root" invoker="get_root">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28543">Gets the root directory on @mount.</doc>
|
|
<source-position filename="gmount.h" line="86"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28549">a #GFile.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28545">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_sort_key" invoker="get_sort_key" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28555">Gets the sort key for @mount, if any.</doc>
|
|
<source-position filename="gmount.h" line="160"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28561">Sorting key for @mount or %NULL if no such key is available.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28557">A #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_symbolic_icon" invoker="get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28566">Gets the symbolic icon for @mount.</doc>
|
|
<source-position filename="gmount.h" line="161"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28572">a #GIcon.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28568">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_uuid" invoker="get_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28579">Gets the UUID for the @mount. The reference is typically based on
|
|
the file system UUID for the mount in question and should be
|
|
considered an opaque string. Returns %NULL if there is no UUID
|
|
available.</doc>
|
|
<source-position filename="gmount.h" line="89"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28588">the UUID for @mount or %NULL if no UUID
|
|
can be computed.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28581">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_volume" invoker="get_volume">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28595">Gets the volume for the @mount.</doc>
|
|
<source-position filename="gmount.h" line="90"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28601">a #GVolume or %NULL if @mount is not
|
|
associated with a volume.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28597">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="guess_content_type" invoker="guess_content_type" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28608">Tries to guess the type of content stored on @mount. Returns one or
|
|
more textual identifiers of well-known content types (typically
|
|
prefixed with "x-content/"), e.g. x-content/image-dcf for camera
|
|
memory cards. See the
|
|
[shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
|
|
specification for more on x-content types.
|
|
|
|
This is an asynchronous operation (see
|
|
g_mount_guess_content_type_sync() for the synchronous version), and
|
|
is finished by calling g_mount_guess_content_type_finish() with the
|
|
@mount and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gmount.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28610">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="force_rescan" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28611">Whether to force a rescan of the content.
|
|
Otherwise a cached result will be used if available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28613">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28614">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28615">user data passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="guess_content_type_finish" invoker="guess_content_type_finish" version="2.18" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28633">Finishes guessing content types of @mount. If any errors occurred
|
|
during the operation, @error will be set to contain the errors and
|
|
%FALSE will be returned. In particular, you may get an
|
|
%G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
|
|
guessing.</doc>
|
|
<source-position filename="gmount.h" line="128"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28646">a %NULL-terminated array of content types or %NULL on error.
|
|
Caller should free this array with g_strfreev() when done with it.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28635">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28636">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="guess_content_type_sync" invoker="guess_content_type_sync" version="2.18" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28652">Tries to guess the type of content stored on @mount. Returns one or
|
|
more textual identifiers of well-known content types (typically
|
|
prefixed with "x-content/"), e.g. x-content/image-dcf for camera
|
|
memory cards. See the
|
|
[shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
|
|
specification for more on x-content types.
|
|
|
|
This is an synchronous operation and as such may block doing IO;
|
|
see g_mount_guess_content_type() for the asynchronous version.</doc>
|
|
<source-position filename="gmount.h" line="131"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28671">a %NULL-terminated array of content types or %NULL on error.
|
|
Caller should free this array with g_strfreev() when done with it.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28654">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="force_rescan" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28655">Whether to force a rescan of the content.
|
|
Otherwise a cached result will be used if available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28657">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="pre_unmount">
|
|
<source-position filename="gmount.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="remount" invoker="remount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28912">Remounts a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_remount_finish() with the @mount
|
|
and #GAsyncResults data returned in the @callback.
|
|
|
|
Remounting is useful when some setting affecting the operation
|
|
of the volume has been changed, as these may need a remount to
|
|
take affect. While this is semantically equivalent with unmounting
|
|
and then remounting not all backends might need to actually be
|
|
unmounted.</doc>
|
|
<source-position filename="gmount.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28914">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28915">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28916">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28918">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28919">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28920">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="remount_finish" invoker="remount_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28934">Finishes remounting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gmount.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28944">%TRUE if the mount was successfully remounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28936">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28937">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount" invoker="unmount" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28961">Unmounts a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_unmount_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_unmount_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28963">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28964">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28965">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28966">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28967">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount_finish" invoker="unmount_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28977">Finishes unmounting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_unmount_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28987">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28979">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28980">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount_with_operation" invoker="unmount_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28992">Unmounts a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_unmount_with_operation_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gmount.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28994">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28995">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28996">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28998">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28999">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29000">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmount_with_operation_finish" invoker="unmount_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29010">Finishes unmounting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gmount.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29020">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29012">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29013">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unmounted">
|
|
<source-position filename="gmount.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="can_eject" c:identifier="g_mount_can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28405">Checks if @mount can be ejected.</doc>
|
|
<source-position filename="gmount.h" line="186"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28411">%TRUE if the @mount can be ejected.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28407">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_unmount" c:identifier="g_mount_can_unmount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28415">Checks if @mount can be unmounted.</doc>
|
|
<source-position filename="gmount.h" line="184"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28421">%TRUE if the @mount can be unmounted.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28417">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject" c:identifier="g_mount_eject" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28425">Ejects a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_eject_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_eject_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="201"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28427">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28428">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28429">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28430">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28431">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_finish" c:identifier="g_mount_eject_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28441">Finishes ejecting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_eject_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="208"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28451">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28443">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28444">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_with_operation" c:identifier="g_mount_eject_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28456">Ejects a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_eject_with_operation_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gmount.h" line="260"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28458">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28459">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28460">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28462">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28463">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28464">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_with_operation_finish" c:identifier="g_mount_eject_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28474">Finishes ejecting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gmount.h" line="267"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28484">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28476">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28477">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_default_location" c:identifier="g_mount_get_default_location">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28489">Gets the default location of @mount. The default location of the given
|
|
@mount is a path that reflects the main entry point for the user (e.g.
|
|
the home directory, or the root of the volume).</doc>
|
|
<source-position filename="gmount.h" line="170"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28497">a #GFile.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28491">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_drive" c:identifier="g_mount_get_drive">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28503">Gets the drive for the @mount.
|
|
|
|
This is a convenience method for getting the #GVolume and then
|
|
using that object to get the #GDrive.</doc>
|
|
<source-position filename="gmount.h" line="182"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28512">a #GDrive or %NULL if @mount is not
|
|
associated with a volume or a drive.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28505">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_icon" c:identifier="g_mount_get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28519">Gets the icon for @mount.</doc>
|
|
<source-position filename="gmount.h" line="174"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28525">a #GIcon.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28521">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_mount_get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28531">Gets the name of @mount.</doc>
|
|
<source-position filename="gmount.h" line="172"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28537">the name for the given @mount.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28533">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_root" c:identifier="g_mount_get_root">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28543">Gets the root directory on @mount.</doc>
|
|
<source-position filename="gmount.h" line="168"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28549">a #GFile.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28545">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sort_key" c:identifier="g_mount_get_sort_key" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28555">Gets the sort key for @mount, if any.</doc>
|
|
<source-position filename="gmount.h" line="272"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28561">Sorting key for @mount or %NULL if no such key is available.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28557">A #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_symbolic_icon" c:identifier="g_mount_get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28566">Gets the symbolic icon for @mount.</doc>
|
|
<source-position filename="gmount.h" line="176"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28572">a #GIcon.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28568">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uuid" c:identifier="g_mount_get_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28579">Gets the UUID for the @mount. The reference is typically based on
|
|
the file system UUID for the mount in question and should be
|
|
considered an opaque string. Returns %NULL if there is no UUID
|
|
available.</doc>
|
|
<source-position filename="gmount.h" line="178"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28588">the UUID for @mount or %NULL if no UUID
|
|
can be computed.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28581">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_volume" c:identifier="g_mount_get_volume">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28595">Gets the volume for the @mount.</doc>
|
|
<source-position filename="gmount.h" line="180"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28601">a #GVolume or %NULL if @mount is not
|
|
associated with a volume.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28597">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="guess_content_type" c:identifier="g_mount_guess_content_type" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28608">Tries to guess the type of content stored on @mount. Returns one or
|
|
more textual identifiers of well-known content types (typically
|
|
prefixed with "x-content/"), e.g. x-content/image-dcf for camera
|
|
memory cards. See the
|
|
[shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
|
|
specification for more on x-content types.
|
|
|
|
This is an asynchronous operation (see
|
|
g_mount_guess_content_type_sync() for the synchronous version), and
|
|
is finished by calling g_mount_guess_content_type_finish() with the
|
|
@mount and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gmount.h" line="225"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28610">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="force_rescan" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28611">Whether to force a rescan of the content.
|
|
Otherwise a cached result will be used if available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28613">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28614">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28615">user data passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="guess_content_type_finish" c:identifier="g_mount_guess_content_type_finish" version="2.18" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28633">Finishes guessing content types of @mount. If any errors occurred
|
|
during the operation, @error will be set to contain the errors and
|
|
%FALSE will be returned. In particular, you may get an
|
|
%G_IO_ERROR_NOT_SUPPORTED if the mount does not support content
|
|
guessing.</doc>
|
|
<source-position filename="gmount.h" line="231"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28646">a %NULL-terminated array of content types or %NULL on error.
|
|
Caller should free this array with g_strfreev() when done with it.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28635">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28636">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="guess_content_type_sync" c:identifier="g_mount_guess_content_type_sync" version="2.18" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28652">Tries to guess the type of content stored on @mount. Returns one or
|
|
more textual identifiers of well-known content types (typically
|
|
prefixed with "x-content/"), e.g. x-content/image-dcf for camera
|
|
memory cards. See the
|
|
[shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
|
|
specification for more on x-content types.
|
|
|
|
This is an synchronous operation and as such may block doing IO;
|
|
see g_mount_guess_content_type() for the asynchronous version.</doc>
|
|
<source-position filename="gmount.h" line="235"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28671">a %NULL-terminated array of content types or %NULL on error.
|
|
Caller should free this array with g_strfreev() when done with it.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28654">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="force_rescan" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28655">Whether to force a rescan of the content.
|
|
Otherwise a cached result will be used if available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28657">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_shadowed" c:identifier="g_mount_is_shadowed" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28677">Determines if @mount is shadowed. Applications or libraries should
|
|
avoid displaying @mount in the user interface if it is shadowed.
|
|
|
|
A mount is said to be shadowed if there exists one or more user
|
|
visible objects (currently #GMount objects) with a root that is
|
|
inside the root of @mount.
|
|
|
|
One application of shadow mounts is when exposing a single file
|
|
system that is used to address several logical volumes. In this
|
|
situation, a #GVolumeMonitor implementation would create two
|
|
#GVolume objects (for example, one for the camera functionality of
|
|
the device and one for a SD card reader on the device) with
|
|
activation URIs `gphoto2://[usb:001,002]/store1/`
|
|
and `gphoto2://[usb:001,002]/store2/`. When the
|
|
underlying mount (with root
|
|
`gphoto2://[usb:001,002]/`) is mounted, said
|
|
#GVolumeMonitor implementation would create two #GMount objects
|
|
(each with their root matching the corresponding volume activation
|
|
root) that would shadow the original mount.
|
|
|
|
The proxy monitor in GVfs 2.26 and later, automatically creates and
|
|
manage shadow mounts (and shadows the underlying mount) if the
|
|
activation root on a #GVolume is set.</doc>
|
|
<source-position filename="gmount.h" line="241"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28705">%TRUE if @mount is shadowed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28679">A #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remount" c:identifier="g_mount_remount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28912">Remounts a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_remount_finish() with the @mount
|
|
and #GAsyncResults data returned in the @callback.
|
|
|
|
Remounting is useful when some setting affecting the operation
|
|
of the volume has been changed, as these may need a remount to
|
|
take affect. While this is semantically equivalent with unmounting
|
|
and then remounting not all backends might need to actually be
|
|
unmounted.</doc>
|
|
<source-position filename="gmount.h" line="213"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28914">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28915">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28916">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28918">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28919">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28920">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remount_finish" c:identifier="g_mount_remount_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28934">Finishes remounting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gmount.h" line="220"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28944">%TRUE if the mount was successfully remounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28936">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28937">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="shadow" c:identifier="g_mount_shadow" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28948">Increments the shadow count on @mount. Usually used by
|
|
#GVolumeMonitor implementations when creating a shadow mount for
|
|
@mount, see g_mount_is_shadowed() for more information. The caller
|
|
will need to emit the #GMount::changed signal on @mount manually.</doc>
|
|
<source-position filename="gmount.h" line="243"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28950">A #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount" c:identifier="g_mount_unmount" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28961">Unmounts a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_unmount_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_unmount_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="189"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28963">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28964">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28965">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28966">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28967">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount_finish" c:identifier="g_mount_unmount_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28977">Finishes unmounting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_mount_unmount_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gmount.h" line="196"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28987">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28979">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28980">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount_with_operation" c:identifier="g_mount_unmount_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28992">Unmounts a mount. This is an asynchronous operation, and is
|
|
finished by calling g_mount_unmount_with_operation_finish() with the @mount
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gmount.h" line="248"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28994">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28995">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28996">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28998">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28999">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29000">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unmount_with_operation_finish" c:identifier="g_mount_unmount_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29010">Finishes unmounting a mount. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gmount.h" line="255"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29020">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29012">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29013">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unshadow" c:identifier="g_mount_unshadow" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29025">Decrements the shadow count on @mount. Usually used by
|
|
#GVolumeMonitor implementations when destroying a shadow mount for
|
|
@mount, see g_mount_is_shadowed() for more information. The caller
|
|
will need to emit the #GMount::changed signal on @mount manually.</doc>
|
|
<source-position filename="gmount.h" line="245"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29027">A #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2238">Emitted when the mount has been changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="pre-unmount" when="last" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2246">This signal may be emitted when the #GMount is about to be
|
|
unmounted.
|
|
|
|
This signal depends on the backend and is only emitted if
|
|
GIO was used to unmount.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="unmounted" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2260">This signal is emitted when the #GMount have been
|
|
unmounted. If the recipient is holding references to the
|
|
object they should release them so the object can be
|
|
finalized.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="MountIface" c:type="GMountIface" glib:is-gtype-struct-for="Mount">
|
|
<doc xml:space="preserve" filename="gmount.h" line="40">Interface for implementing operations for mounts.</doc>
|
|
<source-position filename="gmount.h" line="162"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gmount.h" line="42">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="changed">
|
|
<callback name="changed">
|
|
<source-position filename="gmount.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmounted">
|
|
<callback name="unmounted">
|
|
<source-position filename="gmount.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_root">
|
|
<callback name="get_root">
|
|
<source-position filename="gmount.h" line="86"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28549">a #GFile.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28545">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_name">
|
|
<callback name="get_name">
|
|
<source-position filename="gmount.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28537">the name for the given @mount.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28533">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_icon">
|
|
<callback name="get_icon">
|
|
<source-position filename="gmount.h" line="88"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28525">a #GIcon.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28521">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_uuid">
|
|
<callback name="get_uuid">
|
|
<source-position filename="gmount.h" line="89"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28588">the UUID for @mount or %NULL if no UUID
|
|
can be computed.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28581">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_volume">
|
|
<callback name="get_volume">
|
|
<source-position filename="gmount.h" line="90"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28601">a #GVolume or %NULL if @mount is not
|
|
associated with a volume.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28597">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_drive">
|
|
<callback name="get_drive">
|
|
<source-position filename="gmount.h" line="91"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28512">a #GDrive or %NULL if @mount is not
|
|
associated with a volume or a drive.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28505">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_unmount">
|
|
<callback name="can_unmount">
|
|
<source-position filename="gmount.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28421">%TRUE if the @mount can be unmounted.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28417">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_eject">
|
|
<callback name="can_eject">
|
|
<source-position filename="gmount.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28411">%TRUE if the @mount can be ejected.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28407">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmount">
|
|
<callback name="unmount">
|
|
<source-position filename="gmount.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28963">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28964">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28965">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28966">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28967">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmount_finish">
|
|
<callback name="unmount_finish" throws="1">
|
|
<source-position filename="gmount.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28987">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28979">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28980">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject">
|
|
<callback name="eject">
|
|
<source-position filename="gmount.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28427">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28428">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28429">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28430">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28431">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_finish">
|
|
<callback name="eject_finish" throws="1">
|
|
<source-position filename="gmount.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28451">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28443">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28444">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="remount">
|
|
<callback name="remount">
|
|
<source-position filename="gmount.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28914">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28915">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28916">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28918">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28919">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28920">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="remount_finish">
|
|
<callback name="remount_finish" throws="1">
|
|
<source-position filename="gmount.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28944">%TRUE if the mount was successfully remounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28936">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28937">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="guess_content_type">
|
|
<callback name="guess_content_type">
|
|
<source-position filename="gmount.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28610">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="force_rescan" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28611">Whether to force a rescan of the content.
|
|
Otherwise a cached result will be used if available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28613">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28614">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28615">user data passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="guess_content_type_finish">
|
|
<callback name="guess_content_type_finish" throws="1">
|
|
<source-position filename="gmount.h" line="128"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28646">a %NULL-terminated array of content types or %NULL on error.
|
|
Caller should free this array with g_strfreev() when done with it.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28635">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28636">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="guess_content_type_sync">
|
|
<callback name="guess_content_type_sync" throws="1">
|
|
<source-position filename="gmount.h" line="131"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28671">a %NULL-terminated array of content types or %NULL on error.
|
|
Caller should free this array with g_strfreev() when done with it.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28654">a #GMount</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="force_rescan" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28655">Whether to force a rescan of the content.
|
|
Otherwise a cached result will be used if available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28657">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="pre_unmount">
|
|
<callback name="pre_unmount">
|
|
<source-position filename="gmount.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmount_with_operation">
|
|
<callback name="unmount_with_operation">
|
|
<source-position filename="gmount.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28994">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28995">flags affecting the operation</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28996">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28998">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28999">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29000">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unmount_with_operation_finish">
|
|
<callback name="unmount_with_operation_finish" throws="1">
|
|
<source-position filename="gmount.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29020">%TRUE if the mount was successfully unmounted. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29012">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29013">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_with_operation">
|
|
<callback name="eject_with_operation">
|
|
<source-position filename="gmount.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28458">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28459">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28460">a #GMountOperation or %NULL to avoid
|
|
user interaction.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28462">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28463">a #GAsyncReadyCallback, or %NULL.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28464">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_with_operation_finish">
|
|
<callback name="eject_with_operation_finish" throws="1">
|
|
<source-position filename="gmount.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28484">%TRUE if the mount was successfully ejected. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28476">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28477">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_default_location">
|
|
<callback name="get_default_location">
|
|
<source-position filename="gmount.h" line="158"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28497">a #GFile.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28491">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_sort_key">
|
|
<callback name="get_sort_key">
|
|
<source-position filename="gmount.h" line="160"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28561">Sorting key for @mount or %NULL if no such key is available.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28557">A #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_symbolic_icon">
|
|
<callback name="get_symbolic_icon">
|
|
<source-position filename="gmount.h" line="161"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28572">a #GIcon.
|
|
The returned object should be unreffed with
|
|
g_object_unref() when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28568">a #GMount.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<bitfield name="MountMountFlags" glib:type-name="GMountMountFlags" glib:get-type="g_mount_mount_flags_get_type" c:type="GMountMountFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="236">Flags used when mounting a mount.</doc>
|
|
<member name="none" value="0" c:identifier="G_MOUNT_MOUNT_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="238">No flags set.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<class name="MountOperation" c:symbol-prefix="mount_operation" c:type="GMountOperation" parent="GObject.Object" glib:type-name="GMountOperation" glib:get-type="g_mount_operation_get_type" glib:type-struct="MountOperationClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7068">#GMountOperation provides a mechanism for interacting with the user.
|
|
It can be used for authenticating mountable operations, such as loop
|
|
mounting files, hard drive partitions or server locations. It can
|
|
also be used to ask the user questions or show a list of applications
|
|
preventing unmount or eject operations from completing.
|
|
|
|
Note that #GMountOperation is used for more than just #GMount
|
|
objects – for example it is also used in g_drive_start() and
|
|
g_drive_stop().
|
|
|
|
Users should instantiate a subclass of this that implements all the
|
|
various callbacks to show the required dialogs, such as
|
|
#GtkMountOperation. If no user interaction is desired (for example
|
|
when automounting filesystems at login time), usually %NULL can be
|
|
passed, see each method taking a #GMountOperation for details.
|
|
|
|
The term ‘TCRYPT’ is used to mean ‘compatible with TrueCrypt and VeraCrypt’.
|
|
[TrueCrypt](https://en.wikipedia.org/wiki/TrueCrypt) is a discontinued system for
|
|
encrypting file containers, partitions or whole disks, typically used with Windows.
|
|
[VeraCrypt](https://www.veracrypt.fr/) is a maintained fork of TrueCrypt with various
|
|
improvements and auditing fixes.</doc>
|
|
<source-position filename="gmountoperation.h" line="119"/>
|
|
<constructor name="new" c:identifier="g_mount_operation_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28807">Creates a new mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="124"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28812">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<virtual-method name="aborted">
|
|
<source-position filename="gmountoperation.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="ask_password">
|
|
<source-position filename="gmountoperation.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="default_user" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="default_domain" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<type name="AskPasswordFlags" c:type="GAskPasswordFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="ask_question">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="67">Virtual implementation of #GMountOperation::ask-question.</doc>
|
|
<source-position filename="gmountoperation.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="69">a #GMountOperation</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="70">string containing a message to display to the user</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="choices" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="71">an array of
|
|
strings for each possible choice</doc>
|
|
<array c:type="const char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="reply" invoker="reply">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28816">Emits the #GMountOperation::reply signal.</doc>
|
|
<source-position filename="gmountoperation.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28818">a #GMountOperation</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28819">a #GMountOperationResult</doc>
|
|
<type name="MountOperationResult" c:type="GMountOperationResult"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="show_processes" version="2.22">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="85">Virtual implementation of #GMountOperation::show-processes.</doc>
|
|
<source-position filename="gmountoperation.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="87">a #GMountOperation</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="88">string containing a message to display to the user</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="processes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="89">an array of #GPid for processes blocking
|
|
the operation</doc>
|
|
<array name="GLib.Array" c:type="GArray*">
|
|
<type name="GLib.Pid"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="choices" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="91">an array of
|
|
strings for each possible choice</doc>
|
|
<array c:type="const gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="show_unmount_progress">
|
|
<source-position filename="gmountoperation.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="time_left" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="bytes_left" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_anonymous" c:identifier="g_mount_operation_get_anonymous">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28710">Check to see whether the mount operation is being used
|
|
for an anonymous user.</doc>
|
|
<source-position filename="gmountoperation.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28717">%TRUE if mount operation is anonymous.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28712">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_choice" c:identifier="g_mount_operation_get_choice">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28721">Gets a choice from the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="152"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28727">an integer containing an index of the user's choice from
|
|
the choice's list, or `0`.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28723">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_domain" c:identifier="g_mount_operation_get_domain">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28732">Gets the domain of the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28738">a string set to the domain.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28734">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_tcrypt_hidden_volume" c:identifier="g_mount_operation_get_is_tcrypt_hidden_volume" version="2.58">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28742">Check to see whether the mount operation is being used
|
|
for a TCRYPT hidden volume.</doc>
|
|
<source-position filename="gmountoperation.h" line="160"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28749">%TRUE if mount operation is for hidden volume.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28744">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_tcrypt_system_volume" c:identifier="g_mount_operation_get_is_tcrypt_system_volume" version="2.58">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28754">Check to see whether the mount operation is being used
|
|
for a TCRYPT system volume.</doc>
|
|
<source-position filename="gmountoperation.h" line="165"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28761">%TRUE if mount operation is for system volume.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28756">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_password" c:identifier="g_mount_operation_get_password">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28766">Gets a password from the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28772">a string containing the password within @op.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28768">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_password_save" c:identifier="g_mount_operation_get_password_save">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28776">Gets the state of saving passwords for the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="147"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28782">a #GPasswordSave flag.</doc>
|
|
<type name="PasswordSave" c:type="GPasswordSave"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28778">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_pim" c:identifier="g_mount_operation_get_pim" version="2.58">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28786">Gets a PIM from the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28792">The VeraCrypt PIM within @op.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28788">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_username" c:identifier="g_mount_operation_get_username">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28797">Get the user name from the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="127"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28803">a string containing the user name.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28799">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reply" c:identifier="g_mount_operation_reply">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28816">Emits the #GMountOperation::reply signal.</doc>
|
|
<source-position filename="gmountoperation.h" line="157"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28818">a #GMountOperation</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28819">a #GMountOperationResult</doc>
|
|
<type name="MountOperationResult" c:type="GMountOperationResult"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_anonymous" c:identifier="g_mount_operation_set_anonymous">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28825">Sets the mount operation to use an anonymous user if @anonymous is %TRUE.</doc>
|
|
<source-position filename="gmountoperation.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28827">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="anonymous" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28828">boolean value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_choice" c:identifier="g_mount_operation_set_choice">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28834">Sets a default choice for the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="154"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28836">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="choice" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28837">an integer.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_domain" c:identifier="g_mount_operation_set_domain">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28843">Sets the mount operation's domain.</doc>
|
|
<source-position filename="gmountoperation.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28845">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28846">the domain to set.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_is_tcrypt_hidden_volume" c:identifier="g_mount_operation_set_is_tcrypt_hidden_volume" version="2.58">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28852">Sets the mount operation to use a hidden volume if @hidden_volume is %TRUE.</doc>
|
|
<source-position filename="gmountoperation.h" line="162"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28854">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="hidden_volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28855">boolean value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_is_tcrypt_system_volume" c:identifier="g_mount_operation_set_is_tcrypt_system_volume" version="2.58">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28863">Sets the mount operation to use a system volume if @system_volume is %TRUE.</doc>
|
|
<source-position filename="gmountoperation.h" line="167"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28865">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="system_volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28866">boolean value.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_password" c:identifier="g_mount_operation_set_password">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28874">Sets the mount operation's password to @password.</doc>
|
|
<source-position filename="gmountoperation.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28876">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28877">password to set.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_password_save" c:identifier="g_mount_operation_set_password_save">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28883">Sets the state of saving passwords for the mount operation.</doc>
|
|
<source-position filename="gmountoperation.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28885">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="save" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28886">a set of #GPasswordSave flags.</doc>
|
|
<type name="PasswordSave" c:type="GPasswordSave"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pim" c:identifier="g_mount_operation_set_pim" version="2.58">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28892">Sets the mount operation's PIM to @pim.</doc>
|
|
<source-position filename="gmountoperation.h" line="172"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28894">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="pim" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28895">an unsigned integer.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_username" c:identifier="g_mount_operation_set_username">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28903">Sets the user name within @op to @username.</doc>
|
|
<source-position filename="gmountoperation.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28905">a #GMountOperation.</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</instance-parameter>
|
|
<parameter name="username" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28906">input username.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="anonymous" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2380">Whether to use an anonymous user when authenticating.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="choice" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2387">The index of the user's choice when a question is asked during the
|
|
mount operation. See the #GMountOperation::ask-question signal.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<property name="domain" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2395">The domain to use for the mount operation.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="is-tcrypt-hidden-volume" version="2.58" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2402">Whether the device to be unlocked is a TCRYPT hidden volume.
|
|
See [the VeraCrypt documentation](https://www.veracrypt.fr/en/Hidden%20Volume.html).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="is-tcrypt-system-volume" version="2.58" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2412">Whether the device to be unlocked is a TCRYPT system volume.
|
|
In this context, a system volume is a volume with a bootloader
|
|
and operating system installed. This is only supported for Windows
|
|
operating systems. For further documentation, see
|
|
[the VeraCrypt documentation](https://www.veracrypt.fr/en/System%20Encryption.html).</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="password" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2425">The password that is used for authentication when carrying out
|
|
the mount operation.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="password-save" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2433">Determines if and how the password information should be saved.</doc>
|
|
<type name="PasswordSave"/>
|
|
</property>
|
|
<property name="pim" version="2.58" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2440">The VeraCrypt PIM value, when unlocking a VeraCrypt volume. See
|
|
[the VeraCrypt documentation](https://www.veracrypt.fr/en/Personal%20Iterations%20Multiplier%20(PIM).html).</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="username" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2450">The user name that is used for authentication when carrying out
|
|
the mount operation.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="MountOperationPrivate" c:type="GMountOperationPrivate*"/>
|
|
</field>
|
|
<glib:signal name="aborted" when="last" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2271">Emitted by the backend when e.g. a device becomes unavailable
|
|
while a mount operation is in progress.
|
|
|
|
Implementations of GMountOperation should handle this signal
|
|
by dismissing open password dialogs.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="ask-password" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2284">Emitted when a mount operation asks the user for a password.
|
|
|
|
If the message contains a line break, the first line should be
|
|
presented as a heading. For example, it may be used as the
|
|
primary text in a #GtkMessageDialog.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2287">string containing a message to display to the user.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_user" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2288">string containing the default user name.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2289">string containing the default domain.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2290">a set of #GAskPasswordFlags.</doc>
|
|
<type name="AskPasswordFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="ask-question" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2300">Emitted when asking the user a question and gives a list of
|
|
choices for the user to choose from.
|
|
|
|
If the message contains a line break, the first line should be
|
|
presented as a heading. For example, it may be used as the
|
|
primary text in a #GtkMessageDialog.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2303">string containing a message to display to the user.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="choices" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2304">an array of strings for each possible choice.</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="reply" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2315">Emitted when the user has replied to the mount operation.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2318">a #GMountOperationResult indicating how the request was handled</doc>
|
|
<type name="MountOperationResult"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="show-processes" when="last" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2324">Emitted when one or more processes are blocking an operation
|
|
e.g. unmounting/ejecting a #GMount or stopping a #GDrive.
|
|
|
|
Note that this signal may be emitted several times to update the
|
|
list of blocking processes as processes close files. The
|
|
application should only respond with g_mount_operation_reply() to
|
|
the latest signal (setting #GMountOperation:choice to the choice
|
|
the user made).
|
|
|
|
If the message contains a line break, the first line should be
|
|
presented as a heading. For example, it may be used as the
|
|
primary text in a #GtkMessageDialog.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2327">string containing a message to display to the user.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="processes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2328">an array of #GPid for processes
|
|
blocking the operation.</doc>
|
|
<array name="GLib.Array">
|
|
<type name="GLib.Pid"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="choices" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2330">an array of strings for each possible choice.</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="show-unmount-progress" when="last" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2349">Emitted when an unmount operation has been busy for more than some time
|
|
(typically 1.5 seconds).
|
|
|
|
When unmounting or ejecting a volume, the kernel might need to flush
|
|
pending data in its buffers to the volume stable storage, and this operation
|
|
can take a considerable amount of time. This signal may be emitted several
|
|
times as long as the unmount operation is outstanding, and then one
|
|
last time when the operation is completed, with @bytes_left set to zero.
|
|
|
|
Implementations of GMountOperation should handle this signal by
|
|
showing an UI notification, and then dismiss it, or show another notification
|
|
of completion, when @bytes_left reaches zero.
|
|
|
|
If the message contains a line break, the first line should be
|
|
presented as a heading. For example, it may be used as the
|
|
primary text in a #GtkMessageDialog.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2352">string containing a mesage to display to the user</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
<parameter name="time_left" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2353">the estimated time left before the operation completes,
|
|
in microseconds, or -1</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="bytes_left" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2355">the amount of bytes to be written before the operation
|
|
completes (or -1 if such amount is not known), or zero if the operation
|
|
is completed</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="MountOperationClass" c:type="GMountOperationClass" glib:is-gtype-struct-for="MountOperation">
|
|
<source-position filename="gmountoperation.h" line="119"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="ask_password">
|
|
<callback name="ask_password">
|
|
<source-position filename="gmountoperation.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="op" transfer-ownership="none">
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="default_user" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="default_domain" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<type name="AskPasswordFlags" c:type="GAskPasswordFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="ask_question">
|
|
<callback name="ask_question">
|
|
<source-position filename="gmountoperation.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="69">a #GMountOperation</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="70">string containing a message to display to the user</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="choices" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="71">an array of
|
|
strings for each possible choice</doc>
|
|
<array c:type="const char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="reply">
|
|
<callback name="reply">
|
|
<source-position filename="gmountoperation.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28818">a #GMountOperation</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="28819">a #GMountOperationResult</doc>
|
|
<type name="MountOperationResult" c:type="GMountOperationResult"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="aborted">
|
|
<callback name="aborted">
|
|
<source-position filename="gmountoperation.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="op" transfer-ownership="none">
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="show_processes">
|
|
<callback name="show_processes">
|
|
<source-position filename="gmountoperation.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="op" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="87">a #GMountOperation</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="88">string containing a message to display to the user</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="processes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="89">an array of #GPid for processes blocking
|
|
the operation</doc>
|
|
<array name="GLib.Array" c:type="GArray*">
|
|
<type name="GLib.Pid"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="choices" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmountoperation.h" line="91">an array of
|
|
strings for each possible choice</doc>
|
|
<array c:type="const gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="show_unmount_progress">
|
|
<callback name="show_unmount_progress">
|
|
<source-position filename="gmountoperation.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="op" transfer-ownership="none">
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="time_left" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="bytes_left" transfer-ownership="none">
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gmountoperation.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gmountoperation.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gmountoperation.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gmountoperation.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gmountoperation.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gmountoperation.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved7" introspectable="0">
|
|
<callback name="_g_reserved7">
|
|
<source-position filename="gmountoperation.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved8" introspectable="0">
|
|
<callback name="_g_reserved8">
|
|
<source-position filename="gmountoperation.h" line="117"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved9" introspectable="0">
|
|
<callback name="_g_reserved9">
|
|
<source-position filename="gmountoperation.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="MountOperationPrivate" c:type="GMountOperationPrivate" disguised="1">
|
|
<source-position filename="gmountoperation.h" line="46"/>
|
|
</record>
|
|
<enumeration name="MountOperationResult" glib:type-name="GMountOperationResult" glib:get-type="g_mount_operation_result_get_type" c:type="GMountOperationResult">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="621">#GMountOperationResult is returned as a result when a request for
|
|
information is send by the mounting operation.</doc>
|
|
<member name="handled" value="0" c:identifier="G_MOUNT_OPERATION_HANDLED" glib:nick="handled">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="623">The request was fulfilled and the
|
|
user specified data is now available</doc>
|
|
</member>
|
|
<member name="aborted" value="1" c:identifier="G_MOUNT_OPERATION_ABORTED" glib:nick="aborted">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="625">The user requested the mount operation
|
|
to be aborted</doc>
|
|
</member>
|
|
<member name="unhandled" value="2" c:identifier="G_MOUNT_OPERATION_UNHANDLED" glib:nick="unhandled">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="627">The request was unhandled (i.e. not
|
|
implemented)</doc>
|
|
</member>
|
|
</enumeration>
|
|
<bitfield name="MountUnmountFlags" glib:type-name="GMountUnmountFlags" glib:get-type="g_mount_unmount_flags_get_type" c:type="GMountUnmountFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="247">Flags used when an unmounting a mount.</doc>
|
|
<member name="none" value="0" c:identifier="G_MOUNT_UNMOUNT_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="249">No flags set.</doc>
|
|
</member>
|
|
<member name="force" value="1" c:identifier="G_MOUNT_UNMOUNT_FORCE" glib:nick="force">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="250">Unmount even if there are outstanding
|
|
file operations on the mount.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<function-macro name="NATIVE_SOCKET_ADDRESS" c:identifier="G_NATIVE_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="gnativesocketaddress.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NATIVE_SOCKET_ADDRESS_CLASS" c:identifier="G_NATIVE_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gnativesocketaddress.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NATIVE_SOCKET_ADDRESS_GET_CLASS" c:identifier="G_NATIVE_SOCKET_ADDRESS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gnativesocketaddress.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NATIVE_VOLUME_MONITOR" c:identifier="G_NATIVE_VOLUME_MONITOR" introspectable="0">
|
|
<source-position filename="gnativevolumemonitor.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NATIVE_VOLUME_MONITOR_CLASS" c:identifier="G_NATIVE_VOLUME_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gnativevolumemonitor.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME" value="gio-native-volume-monitor" c:type="G_NATIVE_VOLUME_MONITOR_EXTENSION_POINT_NAME">
|
|
<source-position filename="gnativevolumemonitor.h" line="38"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="NETWORK_ADDRESS" c:identifier="G_NETWORK_ADDRESS" introspectable="0">
|
|
<source-position filename="gnetworkaddress.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NETWORK_ADDRESS_CLASS" c:identifier="G_NETWORK_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gnetworkaddress.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NETWORK_ADDRESS_GET_CLASS" c:identifier="G_NETWORK_ADDRESS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gnetworkaddress.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NETWORK_MONITOR" c:identifier="G_NETWORK_MONITOR" introspectable="0">
|
|
<source-position filename="gnetworkmonitor.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="NETWORK_MONITOR_EXTENSION_POINT_NAME" value="gio-network-monitor" c:type="G_NETWORK_MONITOR_EXTENSION_POINT_NAME" version="2.30">
|
|
<doc xml:space="preserve" filename="gnetworkmonitor.h" line="30">Extension point for network status monitoring functionality.
|
|
See [Extending GIO][extending-gio].</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="38"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="NETWORK_MONITOR_GET_INTERFACE" c:identifier="G_NETWORK_MONITOR_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gnetworkmonitor.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NETWORK_SERVICE" c:identifier="G_NETWORK_SERVICE" introspectable="0">
|
|
<source-position filename="gnetworkservice.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NETWORK_SERVICE_CLASS" c:identifier="G_NETWORK_SERVICE_CLASS" introspectable="0">
|
|
<source-position filename="gnetworkservice.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NETWORK_SERVICE_GET_CLASS" c:identifier="G_NETWORK_SERVICE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gnetworkservice.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="NOTIFICATION" c:identifier="G_NOTIFICATION" introspectable="0">
|
|
<source-position filename="gnotification.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="NativeSocketAddress" c:symbol-prefix="native_socket_address" c:type="GNativeSocketAddress" parent="SocketAddress" glib:type-name="GNativeSocketAddress" glib:get-type="g_native_socket_address_get_type" glib:type-struct="NativeSocketAddressClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7097">An socket address of some unknown native type.</doc>
|
|
<source-position filename="gnativesocketaddress.h" line="54"/>
|
|
<implements name="SocketConnectable"/>
|
|
<constructor name="new" c:identifier="g_native_socket_address_new" version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29038">Creates a new #GNativeSocketAddress for @native and @len.</doc>
|
|
<source-position filename="gnativesocketaddress.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29045">a new #GNativeSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="native" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29040">a native address object</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29041">the length of @native, in bytes</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<field name="parent_instance">
|
|
<type name="SocketAddress" c:type="GSocketAddress"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="NativeSocketAddressPrivate" c:type="GNativeSocketAddressPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="NativeSocketAddressClass" c:type="GNativeSocketAddressClass" glib:is-gtype-struct-for="NativeSocketAddress">
|
|
<source-position filename="gnativesocketaddress.h" line="54"/>
|
|
<field name="parent_class">
|
|
<type name="SocketAddressClass" c:type="GSocketAddressClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="NativeSocketAddressPrivate" c:type="GNativeSocketAddressPrivate" disguised="1">
|
|
<source-position filename="gnativesocketaddress.h" line="41"/>
|
|
</record>
|
|
<class name="NativeVolumeMonitor" c:symbol-prefix="native_volume_monitor" c:type="GNativeVolumeMonitor" parent="VolumeMonitor" abstract="1" glib:type-name="GNativeVolumeMonitor" glib:get-type="g_native_volume_monitor_get_type" glib:type-struct="NativeVolumeMonitorClass">
|
|
<source-position filename="gnativevolumemonitor.h" line="54"/>
|
|
<field name="parent_instance">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor"/>
|
|
</field>
|
|
</class>
|
|
<record name="NativeVolumeMonitorClass" c:type="GNativeVolumeMonitorClass" glib:is-gtype-struct-for="NativeVolumeMonitor">
|
|
<source-position filename="gnativevolumemonitor.h" line="54"/>
|
|
<field name="parent_class">
|
|
<type name="VolumeMonitorClass" c:type="GVolumeMonitorClass"/>
|
|
</field>
|
|
<field name="get_mount_for_mount_path" introspectable="0">
|
|
<callback name="get_mount_for_mount_path" introspectable="0">
|
|
<source-position filename="gnativevolumemonitor.h" line="52"/>
|
|
<return-value>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="NetworkAddress" c:symbol-prefix="network_address" c:type="GNetworkAddress" parent="GObject.Object" glib:type-name="GNetworkAddress" glib:get-type="g_network_address_get_type" glib:type-struct="NetworkAddressClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7106">#GNetworkAddress provides an easy way to resolve a hostname and
|
|
then attempt to connect to that host, handling the possibility of
|
|
multiple IP addresses and multiple address families.
|
|
|
|
The enumeration results of resolved addresses *may* be cached as long
|
|
as this object is kept alive which may have unexpected results if
|
|
alive for too long.
|
|
|
|
See #GSocketConnectable for an example of using the connectable
|
|
interface.</doc>
|
|
<source-position filename="gnetworkaddress.h" line="52"/>
|
|
<implements name="SocketConnectable"/>
|
|
<constructor name="new" c:identifier="g_network_address_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29084">Creates a new #GSocketConnectable for connecting to the given
|
|
@hostname and @port.
|
|
|
|
Note that depending on the configuration of the machine, a
|
|
@hostname of `localhost` may refer to the IPv4 loopback address
|
|
only, or to both IPv4 and IPv6; use
|
|
g_network_address_new_loopback() to create a #GNetworkAddress that
|
|
is guaranteed to resolve to both addresses.</doc>
|
|
<source-position filename="gnetworkaddress.h" line="58"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29098">the new #GNetworkAddress</doc>
|
|
<type name="NetworkAddress" c:type="GSocketConnectable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29086">the hostname</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29087">the port</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_loopback" c:identifier="g_network_address_new_loopback" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29103">Creates a new #GSocketConnectable for connecting to the local host
|
|
over a loopback connection to the given @port. This is intended for
|
|
use in connecting to local services which may be running on IPv4 or
|
|
IPv6.
|
|
|
|
The connectable will return IPv4 and IPv6 loopback addresses,
|
|
regardless of how the host resolves `localhost`. By contrast,
|
|
g_network_address_new() will often only return an IPv4 address when
|
|
resolving `localhost`, and an IPv6 address for `localhost6`.
|
|
|
|
g_network_address_get_hostname() will always return `localhost` for
|
|
a #GNetworkAddress created with this constructor.</doc>
|
|
<source-position filename="gnetworkaddress.h" line="61"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29120">the new #GNetworkAddress</doc>
|
|
<type name="NetworkAddress" c:type="GSocketConnectable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29105">the port</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="parse" c:identifier="g_network_address_parse" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29125">Creates a new #GSocketConnectable for connecting to the given
|
|
@hostname and @port. May fail and return %NULL in case
|
|
parsing @host_and_port fails.
|
|
|
|
@host_and_port may be in any of a number of recognised formats; an IPv6
|
|
address, an IPv4 address, or a domain name (in which case a DNS
|
|
lookup is performed). Quoting with [] is supported for all address
|
|
types. A port override may be specified in the usual way with a
|
|
colon.
|
|
|
|
If no port is specified in @host_and_port then @default_port will be
|
|
used as the port number to connect to.
|
|
|
|
In general, @host_and_port is expected to be provided by the user
|
|
(allowing them to give the hostname, and a port override if necessary)
|
|
and @default_port is expected to be provided by the application.
|
|
|
|
(The port component of @host_and_port can also be specified as a
|
|
service name rather than as a numeric port, but this functionality
|
|
is deprecated, because it depends on the contents of /etc/services,
|
|
which is generally quite sparse on platforms other than Linux.)</doc>
|
|
<source-position filename="gnetworkaddress.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29153">the new
|
|
#GNetworkAddress, or %NULL on error</doc>
|
|
<type name="NetworkAddress" c:type="GSocketConnectable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="host_and_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29127">the hostname and optionally a port</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29128">the default port if not in @host_and_port</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="parse_uri" c:identifier="g_network_address_parse_uri" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29159">Creates a new #GSocketConnectable for connecting to the given
|
|
@uri. May fail and return %NULL in case parsing @uri fails.
|
|
|
|
Using this rather than g_network_address_new() or
|
|
g_network_address_parse() allows #GSocketClient to determine
|
|
when to use application-specific proxy protocols.</doc>
|
|
<source-position filename="gnetworkaddress.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29172">the new
|
|
#GNetworkAddress, or %NULL on error</doc>
|
|
<type name="NetworkAddress" c:type="GSocketConnectable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29161">the hostname and optionally a port</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29162">The default port if none is found in the URI</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="get_hostname" c:identifier="g_network_address_get_hostname" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29050">Gets @addr's hostname. This might be either UTF-8 or ASCII-encoded,
|
|
depending on what @addr was created with.</doc>
|
|
<source-position filename="gnetworkaddress.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29057">@addr's hostname</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="addr" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29052">a #GNetworkAddress</doc>
|
|
<type name="NetworkAddress" c:type="GNetworkAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_port" c:identifier="g_network_address_get_port" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29062">Gets @addr's port number</doc>
|
|
<source-position filename="gnetworkaddress.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29068">@addr's port (which may be 0)</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="addr" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29064">a #GNetworkAddress</doc>
|
|
<type name="NetworkAddress" c:type="GNetworkAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_scheme" c:identifier="g_network_address_get_scheme" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29073">Gets @addr's scheme</doc>
|
|
<source-position filename="gnetworkaddress.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29079">@addr's scheme (%NULL if not built from URI)</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="addr" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29075">a #GNetworkAddress</doc>
|
|
<type name="NetworkAddress" c:type="GNetworkAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="hostname" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="port" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="scheme" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="NetworkAddressPrivate" c:type="GNetworkAddressPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="NetworkAddressClass" c:type="GNetworkAddressClass" glib:is-gtype-struct-for="NetworkAddress">
|
|
<source-position filename="gnetworkaddress.h" line="52"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="NetworkAddressPrivate" c:type="GNetworkAddressPrivate" disguised="1">
|
|
<source-position filename="gnetworkaddress.h" line="38"/>
|
|
</record>
|
|
<enumeration name="NetworkConnectivity" version="2.44" glib:type-name="GNetworkConnectivity" glib:get-type="g_network_connectivity_get_type" c:type="GNetworkConnectivity">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1919">The host's network connectivity state, as reported by #GNetworkMonitor.</doc>
|
|
<member name="local" value="1" c:identifier="G_NETWORK_CONNECTIVITY_LOCAL" glib:nick="local">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1921">The host is not configured with a
|
|
route to the Internet; it may or may not be connected to a local
|
|
network.</doc>
|
|
</member>
|
|
<member name="limited" value="2" c:identifier="G_NETWORK_CONNECTIVITY_LIMITED" glib:nick="limited">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1924">The host is connected to a network, but
|
|
does not appear to be able to reach the full Internet, perhaps
|
|
due to upstream network problems.</doc>
|
|
</member>
|
|
<member name="portal" value="3" c:identifier="G_NETWORK_CONNECTIVITY_PORTAL" glib:nick="portal">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1927">The host is behind a captive portal and
|
|
cannot reach the full Internet.</doc>
|
|
</member>
|
|
<member name="full" value="4" c:identifier="G_NETWORK_CONNECTIVITY_FULL" glib:nick="full">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1929">The host is connected to a network, and
|
|
appears to be able to reach the full Internet.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<interface name="NetworkMonitor" c:symbol-prefix="network_monitor" c:type="GNetworkMonitor" version="2.32" glib:type-name="GNetworkMonitor" glib:get-type="g_network_monitor_get_type" glib:type-struct="NetworkMonitorInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7150">#GNetworkMonitor provides an easy-to-use cross-platform API
|
|
for monitoring network connectivity. On Linux, the available
|
|
implementations are based on the kernel's netlink interface and
|
|
on NetworkManager.
|
|
|
|
There is also an implementation for use inside Flatpak sandboxes.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="65"/>
|
|
<prerequisite name="Initable"/>
|
|
<function name="get_default" c:identifier="g_network_monitor_get_default" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29304">Gets the default #GNetworkMonitor for the system.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29309">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="can_reach" invoker="can_reach" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29211">Attempts to determine whether or not the host pointed to by
|
|
@connectable can be reached, without actually trying to connect to
|
|
it.
|
|
|
|
This may return %TRUE even when #GNetworkMonitor:network-available
|
|
is %FALSE, if, for example, @monitor can determine that
|
|
@connectable refers to a host on a local network.
|
|
|
|
If @monitor believes that an attempt to connect to @connectable
|
|
will succeed, it will return %TRUE. Otherwise, it will return
|
|
%FALSE and set @error to an appropriate error (such as
|
|
%G_IO_ERROR_HOST_UNREACHABLE).
|
|
|
|
Note that although this does not attempt to connect to
|
|
@connectable, it may still block for a brief period of time (eg,
|
|
trying to do multicast DNS on the local network), so if you do not
|
|
want to block, you should use g_network_monitor_can_reach_async().</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29236">%TRUE if @connectable is reachable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29213">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29214">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29215">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_reach_async" invoker="can_reach_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29241">Asynchronously attempts to determine whether or not the host
|
|
pointed to by @connectable can be reached, without actually
|
|
trying to connect to it.
|
|
|
|
For more details, see g_network_monitor_can_reach().
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_network_monitor_can_reach_finish()
|
|
to get the result of the operation.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29243">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29244">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29245">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29246">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29248">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_reach_finish" invoker="can_reach_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29262">Finishes an async network connectivity test.
|
|
See g_network_monitor_can_reach_async().</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29271">%TRUE if network is reachable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29264">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29265">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="network_changed">
|
|
<source-position filename="gnetworkmonitor.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="network_available" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="can_reach" c:identifier="g_network_monitor_can_reach" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29211">Attempts to determine whether or not the host pointed to by
|
|
@connectable can be reached, without actually trying to connect to
|
|
it.
|
|
|
|
This may return %TRUE even when #GNetworkMonitor:network-available
|
|
is %FALSE, if, for example, @monitor can determine that
|
|
@connectable refers to a host on a local network.
|
|
|
|
If @monitor believes that an attempt to connect to @connectable
|
|
will succeed, it will return %TRUE. Otherwise, it will return
|
|
%FALSE and set @error to an appropriate error (such as
|
|
%G_IO_ERROR_HOST_UNREACHABLE).
|
|
|
|
Note that although this does not attempt to connect to
|
|
@connectable, it may still block for a brief period of time (eg,
|
|
trying to do multicast DNS on the local network), so if you do not
|
|
want to block, you should use g_network_monitor_can_reach_async().</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29236">%TRUE if @connectable is reachable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29213">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29214">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29215">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_reach_async" c:identifier="g_network_monitor_can_reach_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29241">Asynchronously attempts to determine whether or not the host
|
|
pointed to by @connectable can be reached, without actually
|
|
trying to connect to it.
|
|
|
|
For more details, see g_network_monitor_can_reach().
|
|
|
|
When the operation is finished, @callback will be called.
|
|
You can then call g_network_monitor_can_reach_finish()
|
|
to get the result of the operation.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29243">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29244">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29245">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29246">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29248">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_reach_finish" c:identifier="g_network_monitor_can_reach_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29262">Finishes an async network connectivity test.
|
|
See g_network_monitor_can_reach_async().</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29271">%TRUE if network is reachable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29264">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29265">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_connectivity" c:identifier="g_network_monitor_get_connectivity" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29275">Gets a more detailed networking state than
|
|
g_network_monitor_get_network_available().
|
|
|
|
If #GNetworkMonitor:network-available is %FALSE, then the
|
|
connectivity state will be %G_NETWORK_CONNECTIVITY_LOCAL.
|
|
|
|
If #GNetworkMonitor:network-available is %TRUE, then the
|
|
connectivity state will be %G_NETWORK_CONNECTIVITY_FULL (if there
|
|
is full Internet connectivity), %G_NETWORK_CONNECTIVITY_LIMITED (if
|
|
the host has a default route, but appears to be unable to actually
|
|
reach the full Internet), or %G_NETWORK_CONNECTIVITY_PORTAL (if the
|
|
host is trapped behind a "captive portal" that requires some sort
|
|
of login or acknowledgement before allowing full Internet access).
|
|
|
|
Note that in the case of %G_NETWORK_CONNECTIVITY_LIMITED and
|
|
%G_NETWORK_CONNECTIVITY_PORTAL, it is possible that some sites are
|
|
reachable but others are not. In this case, applications can
|
|
attempt to connect to remote servers, but should gracefully fall
|
|
back to their "offline" behavior if the connection attempt fails.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29299">the network connectivity state</doc>
|
|
<type name="NetworkConnectivity" c:type="GNetworkConnectivity"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29277">the #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_network_available" c:identifier="g_network_monitor_get_network_available" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29314">Checks if the network is available. "Available" here means that the
|
|
system has a default route available for at least one of IPv4 or
|
|
IPv6. It does not necessarily imply that the public Internet is
|
|
reachable. See #GNetworkMonitor:network-available for more details.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29323">whether the network is available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29316">the #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_network_metered" c:identifier="g_network_monitor_get_network_metered" version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29328">Checks if the network is metered.
|
|
See #GNetworkMonitor:network-metered for more details.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29335">whether the connection is metered</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29330">the #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="connectivity" version="2.44" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2495">More detailed information about the host's network connectivity.
|
|
See g_network_monitor_get_connectivity() and
|
|
#GNetworkConnectivity for more details.</doc>
|
|
<type name="NetworkConnectivity"/>
|
|
</property>
|
|
<property name="network-available" version="2.32" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2506">Whether the network is considered available. That is, whether the
|
|
system has a default route for at least one of IPv4 or IPv6.
|
|
|
|
Real-world networks are of course much more complicated than
|
|
this; the machine may be connected to a wifi hotspot that
|
|
requires payment before allowing traffic through, or may be
|
|
connected to a functioning router that has lost its own upstream
|
|
connectivity. Some hosts might only be accessible when a VPN is
|
|
active. Other hosts might only be accessible when the VPN is
|
|
not active. Thus, it is best to use g_network_monitor_can_reach()
|
|
or g_network_monitor_can_reach_async() to test for reachability
|
|
on a host-by-host basis. (On the other hand, when the property is
|
|
%FALSE, the application can reasonably expect that no remote
|
|
hosts at all are reachable, and should indicate this to the user
|
|
in its UI.)
|
|
|
|
See also #GNetworkMonitor::network-changed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="network-metered" version="2.46" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2531">Whether the network is considered metered. That is, whether the
|
|
system has traffic flowing through the default connection that is
|
|
subject to limitations set by service providers. For example, traffic
|
|
might be billed by the amount of data transmitted, or there might be a
|
|
quota on the amount of traffic per month. This is typical with tethered
|
|
connections (3G and 4G) and in such situations, bandwidth intensive
|
|
applications may wish to avoid network activity where possible if it will
|
|
cost the user money or use up their limited quota.
|
|
|
|
If more information is required about specific devices then the
|
|
system network management API should be used instead (for example,
|
|
NetworkManager or ConnMan).
|
|
|
|
If this information is not available then no networks will be
|
|
marked as metered.
|
|
|
|
See also #GNetworkMonitor:network-available.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<glib:signal name="network-changed" when="last" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2484">Emitted when the network configuration changes.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="network_available" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2487">the current value of #GNetworkMonitor:network-available</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="NetworkMonitorInterface" c:type="GNetworkMonitorInterface" glib:is-gtype-struct-for="NetworkMonitor" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2556">The virtual function table for #GNetworkMonitor.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="65"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2558">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="network_changed">
|
|
<callback name="network_changed">
|
|
<source-position filename="gnetworkmonitor.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="monitor" transfer-ownership="none">
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</parameter>
|
|
<parameter name="network_available" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_reach">
|
|
<callback name="can_reach" throws="1">
|
|
<source-position filename="gnetworkmonitor.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29236">%TRUE if @connectable is reachable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29213">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29214">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29215">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_reach_async">
|
|
<callback name="can_reach_async">
|
|
<source-position filename="gnetworkmonitor.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29243">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29244">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29245">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29246">a #GAsyncReadyCallback to call when the
|
|
request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29248">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_reach_finish">
|
|
<callback name="can_reach_finish" throws="1">
|
|
<source-position filename="gnetworkmonitor.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29271">%TRUE if network is reachable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29264">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29265">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="NetworkService" c:symbol-prefix="network_service" c:type="GNetworkService" parent="GObject.Object" glib:type-name="GNetworkService" glib:get-type="g_network_service_get_type" glib:type-struct="NetworkServiceClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7165">Like #GNetworkAddress does with hostnames, #GNetworkService
|
|
provides an easy way to resolve a SRV record, and then attempt to
|
|
connect to one of the hosts that implements that service, handling
|
|
service priority/weighting, multiple IP addresses, and multiple
|
|
address families.
|
|
|
|
See #GSrvTarget for more information about SRV records, and see
|
|
#GSocketConnectable for an example of using the connectable
|
|
interface.</doc>
|
|
<source-position filename="gnetworkservice.h" line="52"/>
|
|
<implements name="SocketConnectable"/>
|
|
<constructor name="new" c:identifier="g_network_service_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29386">Creates a new #GNetworkService representing the given @service,
|
|
@protocol, and @domain. This will initially be unresolved; use the
|
|
#GSocketConnectable interface to resolve it.</doc>
|
|
<source-position filename="gnetworkservice.h" line="58"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29396">a new #GNetworkService</doc>
|
|
<type name="NetworkService" c:type="GSocketConnectable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29388">the service type to look up (eg, "ldap")</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29389">the networking protocol to use for @service (eg, "tcp")</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29390">the DNS domain to look up the service in</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_domain" c:identifier="g_network_service_get_domain" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29340">Gets the domain that @srv serves. This might be either UTF-8 or
|
|
ASCII-encoded, depending on what @srv was created with.</doc>
|
|
<source-position filename="gnetworkservice.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29347">@srv's domain name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="srv" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29342">a #GNetworkService</doc>
|
|
<type name="NetworkService" c:type="GNetworkService*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_protocol" c:identifier="g_network_service_get_protocol" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29352">Gets @srv's protocol name (eg, "tcp").</doc>
|
|
<source-position filename="gnetworkservice.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29358">@srv's protocol name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="srv" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29354">a #GNetworkService</doc>
|
|
<type name="NetworkService" c:type="GNetworkService*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_scheme" c:identifier="g_network_service_get_scheme" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29363">Get's the URI scheme used to resolve proxies. By default, the service name
|
|
is used as scheme.</doc>
|
|
<source-position filename="gnetworkservice.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29370">@srv's scheme name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="srv" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29365">a #GNetworkService</doc>
|
|
<type name="NetworkService" c:type="GNetworkService*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_service" c:identifier="g_network_service_get_service" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29375">Gets @srv's service name (eg, "ldap").</doc>
|
|
<source-position filename="gnetworkservice.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29381">@srv's service name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="srv" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29377">a #GNetworkService</doc>
|
|
<type name="NetworkService" c:type="GNetworkService*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_scheme" c:identifier="g_network_service_set_scheme" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29401">Set's the URI scheme used to resolve proxies. By default, the service name
|
|
is used as scheme.</doc>
|
|
<source-position filename="gnetworkservice.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="srv" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29403">a #GNetworkService</doc>
|
|
<type name="NetworkService" c:type="GNetworkService*"/>
|
|
</instance-parameter>
|
|
<parameter name="scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29404">a URI scheme</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="domain" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="protocol" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="scheme" writable="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="service" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="NetworkServicePrivate" c:type="GNetworkServicePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="NetworkServiceClass" c:type="GNetworkServiceClass" glib:is-gtype-struct-for="NetworkService">
|
|
<source-position filename="gnetworkservice.h" line="52"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="NetworkServicePrivate" c:type="GNetworkServicePrivate" disguised="1">
|
|
<source-position filename="gnetworkservice.h" line="38"/>
|
|
</record>
|
|
<class name="Notification" c:symbol-prefix="notification" c:type="GNotification" version="2.40" parent="GObject.Object" glib:type-name="GNotification" glib:get-type="g_notification_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7182">#GNotification is a mechanism for creating a notification to be shown
|
|
to the user -- typically as a pop-up notification presented by the
|
|
desktop environment shell.
|
|
|
|
The key difference between #GNotification and other similar APIs is
|
|
that, if supported by the desktop environment, notifications sent
|
|
with #GNotification will persist after the application has exited,
|
|
and even across system reboots.
|
|
|
|
Since the user may click on a notification while the application is
|
|
not running, applications using #GNotification should be able to be
|
|
started as a D-Bus service, using #GApplication.
|
|
|
|
User interaction with a notification (either the default action, or
|
|
buttons) must be associated with actions on the application (ie:
|
|
"app." actions). It is not possible to route user interaction
|
|
through the notification itself, because the object will not exist if
|
|
the application is autostarted as a result of a notification being
|
|
clicked.
|
|
|
|
A notification can be sent with g_application_send_notification().</doc>
|
|
<constructor name="new" c:identifier="g_notification_new" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29481">Creates a new #GNotification with @title as its title.
|
|
|
|
After populating @notification with more details, it can be sent to
|
|
the desktop shell with g_application_send_notification(). Changing
|
|
any properties after this call will not have any effect until
|
|
resending @notification.</doc>
|
|
<source-position filename="gnotification.h" line="40"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29492">a new #GNotification instance</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="title" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29483">the title of the notification</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="add_button" c:identifier="g_notification_add_button" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29425">Adds a button to @notification that activates the action in
|
|
@detailed_action when clicked. That action must be an
|
|
application-wide action (starting with "app."). If @detailed_action
|
|
contains a target, the action will be activated with that target as
|
|
its parameter.
|
|
|
|
See g_action_parse_detailed_name() for a description of the format
|
|
for @detailed_action.</doc>
|
|
<source-position filename="gnotification.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29427">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29428">label of the button</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="detailed_action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29429">a detailed action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_button_with_target" c:identifier="g_notification_add_button_with_target" shadowed-by="add_button_with_target_value" version="2.40" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29444">Adds a button to @notification that activates @action when clicked.
|
|
@action must be an application-wide action (it must start with "app.").
|
|
|
|
If @target_format is given, it is used to collect remaining
|
|
positional parameters into a #GVariant instance, similar to
|
|
g_variant_new(). @action will be activated with that #GVariant as its
|
|
parameter.</doc>
|
|
<source-position filename="gnotification.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29446">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29447">label of the button</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29448">an action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="target_format" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29449">a #GVariant format string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29450">positional parameters, as determined by @target_format</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_button_with_target_value" c:identifier="g_notification_add_button_with_target_value" shadows="add_button_with_target" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29464">Adds a button to @notification that activates @action when clicked.
|
|
@action must be an application-wide action (it must start with "app.").
|
|
|
|
If @target is non-%NULL, @action will be activated with @target as
|
|
its parameter.</doc>
|
|
<source-position filename="gnotification.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29466">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="label" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29467">label of the button</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29468">an action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="target" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29469">a #GVariant to use as @action's parameter, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_body" c:identifier="g_notification_set_body" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29497">Sets the body of @notification to @body.</doc>
|
|
<source-position filename="gnotification.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29499">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="body" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29500">the new body for @notification, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_default_action" c:identifier="g_notification_set_default_action" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29508">Sets the default action of @notification to @detailed_action. This
|
|
action is activated when the notification is clicked on.
|
|
|
|
The action in @detailed_action must be an application-wide action (it
|
|
must start with "app."). If @detailed_action contains a target, the
|
|
given action will be activated with that target as its parameter.
|
|
See g_action_parse_detailed_name() for a description of the format
|
|
for @detailed_action.
|
|
|
|
When no default action is set, the application that the notification
|
|
was sent on is activated.</doc>
|
|
<source-position filename="gnotification.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29510">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="detailed_action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29511">a detailed action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_default_action_and_target" c:identifier="g_notification_set_default_action_and_target" shadowed-by="set_default_action_and_target_value" version="2.40" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29529">Sets the default action of @notification to @action. This action is
|
|
activated when the notification is clicked on. It must be an
|
|
application-wide action (it must start with "app.").
|
|
|
|
If @target_format is given, it is used to collect remaining
|
|
positional parameters into a #GVariant instance, similar to
|
|
g_variant_new(). @action will be activated with that #GVariant as its
|
|
parameter.
|
|
|
|
When no default action is set, the application that the notification
|
|
was sent on is activated.</doc>
|
|
<source-position filename="gnotification.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29531">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29532">an action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="target_format" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29533">a #GVariant format string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29534">positional parameters, as determined by @target_format</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_default_action_and_target_value" c:identifier="g_notification_set_default_action_and_target_value" shadows="set_default_action_and_target" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29552">Sets the default action of @notification to @action. This action is
|
|
activated when the notification is clicked on. It must be an
|
|
application-wide action (start with "app.").
|
|
|
|
If @target is non-%NULL, @action will be activated with @target as
|
|
its parameter.
|
|
|
|
When no default action is set, the application that the notification
|
|
was sent on is activated.</doc>
|
|
<source-position filename="gnotification.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29554">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29555">an action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="target" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29556">a #GVariant to use as @action's parameter, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_icon" c:identifier="g_notification_set_icon" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29572">Sets the icon of @notification to @icon.</doc>
|
|
<source-position filename="gnotification.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29574">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29575">the icon to be shown in @notification, as a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_priority" c:identifier="g_notification_set_priority">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29583">Sets the priority of @notification to @priority. See
|
|
#GNotificationPriority for possible values.</doc>
|
|
<source-position filename="gnotification.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29585">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29586">a #GNotificationPriority</doc>
|
|
<type name="NotificationPriority" c:type="GNotificationPriority"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_title" c:identifier="g_notification_set_title" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29593">Sets the title of @notification to @title.</doc>
|
|
<source-position filename="gnotification.h" line="43"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29595">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="title" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29596">the new title for @notification</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_urgent" c:identifier="g_notification_set_urgent" version="2.40" deprecated="1" deprecated-version="2.42">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29604">Deprecated in favor of g_notification_set_priority().</doc>
|
|
<doc-deprecated xml:space="preserve">Since 2.42, this has been deprecated in favour of
|
|
g_notification_set_priority().</doc-deprecated>
|
|
<source-position filename="gnotification.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="notification" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29606">a #GNotification</doc>
|
|
<type name="Notification" c:type="GNotification*"/>
|
|
</instance-parameter>
|
|
<parameter name="urgent" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29607">%TRUE if @notification is urgent</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<enumeration name="NotificationPriority" version="2.42" glib:type-name="GNotificationPriority" glib:get-type="g_notification_priority_get_type" c:type="GNotificationPriority">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1893">Priority levels for #GNotifications.</doc>
|
|
<member name="normal" value="0" c:identifier="G_NOTIFICATION_PRIORITY_NORMAL" glib:nick="normal">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1898">the default priority, to be used for the
|
|
majority of notifications (for example email messages, software updates,
|
|
completed download/sync operations)</doc>
|
|
</member>
|
|
<member name="low" value="1" c:identifier="G_NOTIFICATION_PRIORITY_LOW" glib:nick="low">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1895">for notifications that do not require
|
|
immediate attention - typically used for contextual background
|
|
information, such as contact birthdays or local weather</doc>
|
|
</member>
|
|
<member name="high" value="2" c:identifier="G_NOTIFICATION_PRIORITY_HIGH" glib:nick="high">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1901">for events that require more attention,
|
|
usually because responses are time-sensitive (for example chat and SMS
|
|
messages or alarms)</doc>
|
|
</member>
|
|
<member name="urgent" value="3" c:identifier="G_NOTIFICATION_PRIORITY_URGENT" glib:nick="urgent">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1904">for urgent notifications, or notifications
|
|
that require a response in a short space of time (for example phone calls
|
|
or emergency warnings)</doc>
|
|
</member>
|
|
</enumeration>
|
|
<function-macro name="OUTPUT_STREAM" c:identifier="G_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="goutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="OUTPUT_STREAM_CLASS" c:identifier="G_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="goutputstream.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="OUTPUT_STREAM_GET_CLASS" c:identifier="G_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="goutputstream.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<record name="OutputMessage" c:type="GOutputMessage" version="2.44">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="512">Structure used for scatter/gather data output when sending multiple
|
|
messages or packets in one go. You generally pass in an array of
|
|
#GOutputVectors and the operation will use all the buffers as if they
|
|
were one buffer.
|
|
|
|
If @address is %NULL then the message is sent to the default receiver
|
|
(as previously set by g_socket_connect()).</doc>
|
|
<source-position filename="giotypes.h" line="545"/>
|
|
<field name="address" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="514">a #GSocketAddress, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</field>
|
|
<field name="vectors" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="515">pointer to an array of output vectors</doc>
|
|
<type name="OutputVector" c:type="GOutputVector*"/>
|
|
</field>
|
|
<field name="num_vectors" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="516">the number of output vectors pointed to by @vectors.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="bytes_sent" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="517">initialize to 0. Will be set to the number of bytes
|
|
that have been sent</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
<field name="control_messages" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="519">a pointer
|
|
to an array of #GSocketControlMessages, or %NULL.</doc>
|
|
<array length="5" zero-terminated="0" c:type="GSocketControlMessage**">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</array>
|
|
</field>
|
|
<field name="num_control_messages" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="521">number of elements in @control_messages.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</field>
|
|
</record>
|
|
<class name="OutputStream" c:symbol-prefix="output_stream" c:type="GOutputStream" parent="GObject.Object" abstract="1" glib:type-name="GOutputStream" glib:get-type="g_output_stream_get_type" glib:type-struct="OutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7213">#GOutputStream has functions to write to a stream (g_output_stream_write()),
|
|
to close a stream (g_output_stream_close()) and to flush pending writes
|
|
(g_output_stream_flush()).
|
|
|
|
To copy the content of an input stream to an output stream without
|
|
manually handling the reads and writes, use g_output_stream_splice().
|
|
|
|
See the documentation for #GIOStream for details of thread safety of
|
|
streaming APIs.
|
|
|
|
All of these functions have async variants too.</doc>
|
|
<source-position filename="goutputstream.h" line="149"/>
|
|
<virtual-method name="close_async" invoker="close_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29678">Requests an asynchronous close of the stream, releasing resources
|
|
related to it. When the operation is finished @callback will be
|
|
called. You can then call g_output_stream_close_finish() to get
|
|
the result of the operation.
|
|
|
|
For behaviour details see g_output_stream_close().
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.</doc>
|
|
<source-position filename="goutputstream.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29680">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29681">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29682">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29683">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29684">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_finish" invoker="close_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29699">Closes an output stream.</doc>
|
|
<source-position filename="goutputstream.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29708">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29701">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29702">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="close_fn" throws="1">
|
|
<source-position filename="goutputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="flush" invoker="flush" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29712">Forces a write of all user-space buffered data for the given
|
|
@stream. Will block during the operation. Closing the stream will
|
|
implicitly cause a flush.
|
|
|
|
This function is optional for inherited classes.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="goutputstream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29728">%TRUE on success, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29714">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29715">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="flush_async" invoker="flush_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29732">Forces an asynchronous write of all user-space buffered data for
|
|
the given @stream.
|
|
For behaviour details see g_output_stream_flush().
|
|
|
|
When the operation is finished @callback will be
|
|
called. You can then call g_output_stream_flush_finish() to get the
|
|
result of the operation.</doc>
|
|
<source-position filename="goutputstream.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29734">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29735">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29736">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29737">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29738">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="flush_finish" invoker="flush_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29750">Finishes flushing an output stream.</doc>
|
|
<source-position filename="goutputstream.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29759">%TRUE if flush operation succeeded, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29752">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29753">a GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="splice" invoker="splice" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29839">Splices an input stream into an output stream.</doc>
|
|
<source-position filename="goutputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29850">a #gssize containing the size of the data spliced, or
|
|
-1 if an error occurred. Note that if the number of bytes
|
|
spliced is greater than %G_MAXSSIZE, then that will be
|
|
returned, and there is no way to determine the actual number
|
|
of bytes spliced.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29841">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29842">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29843">a set of #GOutputStreamSpliceFlags.</doc>
|
|
<type name="OutputStreamSpliceFlags" c:type="GOutputStreamSpliceFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29844">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="splice_async" invoker="splice_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29858">Splices a stream asynchronously.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_splice_finish() to get the
|
|
result of the operation.
|
|
|
|
For the synchronous, blocking version of this function, see
|
|
g_output_stream_splice().</doc>
|
|
<source-position filename="goutputstream.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29860">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29861">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29862">a set of #GOutputStreamSpliceFlags.</doc>
|
|
<type name="OutputStreamSpliceFlags" c:type="GOutputStreamSpliceFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29863">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29864">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29865">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29866">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="splice_finish" invoker="splice_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29878">Finishes an asynchronous stream splice operation.</doc>
|
|
<source-position filename="goutputstream.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29887">a #gssize of the number of bytes spliced. Note that if the
|
|
number of bytes spliced is greater than %G_MAXSSIZE, then that
|
|
will be returned, and there is no way to determine the actual
|
|
number of bytes spliced.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29880">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29881">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="write_async" invoker="write_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30042">Request an asynchronous write of @count bytes from @buffer into
|
|
the stream. When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_write_finish() to get the result of the
|
|
operation.
|
|
|
|
During an async request no other sync and async calls are allowed,
|
|
and will result in %G_IO_ERROR_PENDING errors.
|
|
|
|
A value of @count larger than %G_MAXSSIZE will cause a
|
|
%G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes written will be passed to the
|
|
@callback. It is not an error if this is not the same as the
|
|
requested size, as it can happen e.g. on a partial I/O error,
|
|
but generally we try to write as many bytes as requested.
|
|
|
|
You are guaranteed that this method will never fail with
|
|
%G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the
|
|
method will just wait until this changes.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.
|
|
|
|
For the synchronous, blocking version of this function, see
|
|
g_output_stream_write().
|
|
|
|
Note that no copy of @buffer will be made, so it must stay valid
|
|
until @callback is called. See g_output_stream_write_bytes_async()
|
|
for a #GBytes version that will automatically hold a reference to
|
|
the contents (without copying) for the duration of the call.</doc>
|
|
<source-position filename="goutputstream.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30044">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30045">the buffer containing the data to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30046">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30047">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30048">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30049">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30050">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="write_finish" invoker="write_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30151">Finishes a stream write operation.</doc>
|
|
<source-position filename="goutputstream.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30160">a #gssize containing the number of bytes written to the stream.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30153">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30154">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="write_fn" invoker="write" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29922">Tries to write @count bytes from @buffer into the stream. Will block
|
|
during the operation.
|
|
|
|
If count is 0, returns 0 and does nothing. A value of @count
|
|
larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes written to the stream is returned.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. on a partial I/O error, or if there is not enough
|
|
storage in the stream. All writes block until at least one byte
|
|
is written or an error occurs; 0 is never returned (unless
|
|
@count is 0).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="goutputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29951">Number of bytes written, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29924">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29925">the buffer containing the data to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29926">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29927">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="writev_async" invoker="writev_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30295">Request an asynchronous write of the bytes contained in @n_vectors @vectors into
|
|
the stream. When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_writev_finish() to get the result of the
|
|
operation.
|
|
|
|
During an async request no other sync and async calls are allowed,
|
|
and will result in %G_IO_ERROR_PENDING errors.
|
|
|
|
On success, the number of bytes written will be passed to the
|
|
@callback. It is not an error if this is not the same as the
|
|
requested size, as it can happen e.g. on a partial I/O error,
|
|
but generally we try to write as many bytes as requested.
|
|
|
|
You are guaranteed that this method will never fail with
|
|
%G_IO_ERROR_WOULD_BLOCK — if @stream can't accept more data, the
|
|
method will just wait until this changes.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.
|
|
|
|
For the synchronous, blocking version of this function, see
|
|
g_output_stream_writev().
|
|
|
|
Note that no copy of @vectors will be made, so it must stay valid
|
|
until @callback is called.</doc>
|
|
<source-position filename="goutputstream.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30297">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30298">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30299">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30300">the I/O priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30301">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30302">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30303">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="writev_finish" invoker="writev_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30340">Finishes a stream writev operation.</doc>
|
|
<source-position filename="goutputstream.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30350">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30342">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30343">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30344">location to store the number of bytes that were written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="writev_fn" invoker="writev" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30164">Tries to write the bytes contained in the @n_vectors @vectors into the
|
|
stream. Will block during the operation.
|
|
|
|
If @n_vectors is 0 or the sum of all bytes in @vectors is 0, returns 0 and
|
|
does nothing.
|
|
|
|
On success, the number of bytes written to the stream is returned.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. on a partial I/O error, or if there is not enough
|
|
storage in the stream. All writes block until at least one byte
|
|
is written or an error occurs; 0 is never returned (unless
|
|
@n_vectors is 0 or the sum of all bytes in @vectors is 0).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
Some implementations of g_output_stream_writev() may have limitations on the
|
|
aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these
|
|
are exceeded. For example, when writing to a local file on UNIX platforms,
|
|
the aggregate buffer size must not exceed %G_MAXSSIZE bytes.</doc>
|
|
<source-position filename="goutputstream.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30198">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30166">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30167">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30168">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30169">location to store the number of bytes that were
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30171">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="clear_pending" c:identifier="g_output_stream_clear_pending">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29630">Clears the pending flag on @stream.</doc>
|
|
<source-position filename="goutputstream.h" line="327"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29632">output stream</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close" c:identifier="g_output_stream_close" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29638">Closes the stream, releasing resources related to it.
|
|
|
|
Once the stream is closed, all other operations will return %G_IO_ERROR_CLOSED.
|
|
Closing a stream multiple times will not return an error.
|
|
|
|
Closing a stream will automatically flush any outstanding buffers in the
|
|
stream.
|
|
|
|
Streams will be automatically closed when the last reference
|
|
is dropped, but you might want to call this function to make sure
|
|
resources are released as early as possible.
|
|
|
|
Some streams might keep the backing store of the stream (e.g. a file descriptor)
|
|
open after the stream is closed. See the documentation for the individual
|
|
stream for details.
|
|
|
|
On failure the first error that happened will be reported, but the close
|
|
operation will finish as much as possible. A stream that failed to
|
|
close will still return %G_IO_ERROR_CLOSED for all operations. Still, it
|
|
is important to check and report the error to the user, otherwise
|
|
there might be a loss of data as all data might not be written.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.
|
|
Cancelling a close will still leave the stream closed, but there some streams
|
|
can use a faster close that doesn't block to e.g. check errors. On
|
|
cancellation (as with any error) there is no guarantee that all written
|
|
data will reach the target.</doc>
|
|
<source-position filename="goutputstream.h" line="213"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29674">%TRUE on success, %FALSE on failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29640">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29641">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_async" c:identifier="g_output_stream_close_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29678">Requests an asynchronous close of the stream, releasing resources
|
|
related to it. When the operation is finished @callback will be
|
|
called. You can then call g_output_stream_close_finish() to get
|
|
the result of the operation.
|
|
|
|
For behaviour details see g_output_stream_close().
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.</doc>
|
|
<source-position filename="goutputstream.h" line="307"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29680">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29681">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29682">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29683">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29684">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close_finish" c:identifier="g_output_stream_close_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29699">Closes an output stream.</doc>
|
|
<source-position filename="goutputstream.h" line="313"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29708">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29701">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29702">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush" c:identifier="g_output_stream_flush" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29712">Forces a write of all user-space buffered data for the given
|
|
@stream. Will block during the operation. Closing the stream will
|
|
implicitly cause a flush.
|
|
|
|
This function is optional for inherited classes.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="goutputstream.h" line="209"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29728">%TRUE on success, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29714">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29715">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush_async" c:identifier="g_output_stream_flush_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29732">Forces an asynchronous write of all user-space buffered data for
|
|
the given @stream.
|
|
For behaviour details see g_output_stream_flush().
|
|
|
|
When the operation is finished @callback will be
|
|
called. You can then call g_output_stream_flush_finish() to get the
|
|
result of the operation.</doc>
|
|
<source-position filename="goutputstream.h" line="297"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29734">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29735">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29736">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29737">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29738">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="flush_finish" c:identifier="g_output_stream_flush_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29750">Finishes flushing an output stream.</doc>
|
|
<source-position filename="goutputstream.h" line="303"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29759">%TRUE if flush operation succeeded, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29752">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29753">a GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_pending" c:identifier="g_output_stream_has_pending">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29763">Checks if an output stream has pending actions.</doc>
|
|
<source-position filename="goutputstream.h" line="322"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29769">%TRUE if @stream has pending actions.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29765">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_closed" c:identifier="g_output_stream_is_closed">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29773">Checks if an output stream has already been closed.</doc>
|
|
<source-position filename="goutputstream.h" line="318"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29779">%TRUE if @stream is closed. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29775">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_closing" c:identifier="g_output_stream_is_closing" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29783">Checks if an output stream is being closed. This can be
|
|
used inside e.g. a flush implementation to see if the
|
|
flush (or other i/o operation) is called from within
|
|
the closing operation.</doc>
|
|
<source-position filename="goutputstream.h" line="320"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29792">%TRUE if @stream is being closed. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29785">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="printf" c:identifier="g_output_stream_printf" version="2.40" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29797">This is a utility function around g_output_stream_write_all(). It
|
|
uses g_strdup_vprintf() to turn @format and @... into a string that
|
|
is then written to @stream.
|
|
|
|
See the documentation of g_output_stream_write_all() about the
|
|
behavior of the actual write operation.
|
|
|
|
Note that partial writes cannot be properly checked with this
|
|
function due to the variable length of the written string, if you
|
|
need precise control over partial write failures, you need to
|
|
create you own printf()-like wrapper around g_output_stream_write()
|
|
or g_output_stream_write_all().</doc>
|
|
<source-position filename="goutputstream.h" line="184"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29821">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29799">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29800">location to store the number of bytes that was
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29802">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29803">location to store the error occurring, or %NULL to ignore</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29804">the format string. See the printf() documentation</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29805">the parameters to insert into the format string</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_pending" c:identifier="g_output_stream_set_pending" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29825">Sets @stream to have actions pending. If the pending flag is
|
|
already set or @stream is closed, it will return %FALSE and set
|
|
@error.</doc>
|
|
<source-position filename="goutputstream.h" line="324"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29835">%TRUE if pending was previously unset and is now set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29827">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="splice" c:identifier="g_output_stream_splice" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29839">Splices an input stream into an output stream.</doc>
|
|
<source-position filename="goutputstream.h" line="203"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29850">a #gssize containing the size of the data spliced, or
|
|
-1 if an error occurred. Note that if the number of bytes
|
|
spliced is greater than %G_MAXSSIZE, then that will be
|
|
returned, and there is no way to determine the actual number
|
|
of bytes spliced.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29841">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29842">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29843">a set of #GOutputStreamSpliceFlags.</doc>
|
|
<type name="OutputStreamSpliceFlags" c:type="GOutputStreamSpliceFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29844">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="splice_async" c:identifier="g_output_stream_splice_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29858">Splices a stream asynchronously.
|
|
When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_splice_finish() to get the
|
|
result of the operation.
|
|
|
|
For the synchronous, blocking version of this function, see
|
|
g_output_stream_splice().</doc>
|
|
<source-position filename="goutputstream.h" line="285"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29860">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29861">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29862">a set of #GOutputStreamSpliceFlags.</doc>
|
|
<type name="OutputStreamSpliceFlags" c:type="GOutputStreamSpliceFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29863">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29864">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29865">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29866">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="splice_finish" c:identifier="g_output_stream_splice_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29878">Finishes an asynchronous stream splice operation.</doc>
|
|
<source-position filename="goutputstream.h" line="293"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29887">a #gssize of the number of bytes spliced. Note that if the
|
|
number of bytes spliced is greater than %G_MAXSSIZE, then that
|
|
will be returned, and there is no way to determine the actual
|
|
number of bytes spliced.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29880">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29881">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="vprintf" c:identifier="g_output_stream_vprintf" version="2.40" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29894">This is a utility function around g_output_stream_write_all(). It
|
|
uses g_strdup_vprintf() to turn @format and @args into a string that
|
|
is then written to @stream.
|
|
|
|
See the documentation of g_output_stream_write_all() about the
|
|
behavior of the actual write operation.
|
|
|
|
Note that partial writes cannot be properly checked with this
|
|
function due to the variable length of the written string, if you
|
|
need precise control over partial write failures, you need to
|
|
create you own printf()-like wrapper around g_output_stream_write()
|
|
or g_output_stream_write_all().</doc>
|
|
<source-position filename="goutputstream.h" line="191"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29918">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29896">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29897">location to store the number of bytes that was
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29899">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29900">location to store the error occurring, or %NULL to ignore</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29901">the format string. See the printf() documentation</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="args" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29902">the parameters to insert into the format string</doc>
|
|
<type name="va_list" c:type="va_list"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write" c:identifier="g_output_stream_write" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29922">Tries to write @count bytes from @buffer into the stream. Will block
|
|
during the operation.
|
|
|
|
If count is 0, returns 0 and does nothing. A value of @count
|
|
larger than %G_MAXSSIZE will cause a %G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes written to the stream is returned.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. on a partial I/O error, or if there is not enough
|
|
storage in the stream. All writes block until at least one byte
|
|
is written or an error occurs; 0 is never returned (unless
|
|
@count is 0).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="goutputstream.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29951">Number of bytes written, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29924">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29925">the buffer containing the data to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29926">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29927">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_all" c:identifier="g_output_stream_write_all" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29955">Tries to write @count bytes from @buffer into the stream. Will block
|
|
during the operation.
|
|
|
|
This function is similar to g_output_stream_write(), except it tries to
|
|
write as many bytes as requested, only stopping on an error.
|
|
|
|
On a successful write of @count bytes, %TRUE is returned, and @bytes_written
|
|
is set to @count.
|
|
|
|
If there is an error during the operation %FALSE is returned and @error
|
|
is set to indicate the error status.
|
|
|
|
As a special exception to the normal conventions for functions that
|
|
use #GError, if this function returns %FALSE (and sets @error) then
|
|
@bytes_written will be set to the number of bytes that were
|
|
successfully written before the error was encountered. This
|
|
functionality is only available from C. If you need it from another
|
|
language then you must write your own loop around
|
|
g_output_stream_write().</doc>
|
|
<source-position filename="goutputstream.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29985">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29957">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29958">the buffer containing the data to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29959">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29960">location to store the number of bytes that was
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29962">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_all_async" c:identifier="g_output_stream_write_all_async" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29989">Request an asynchronous write of @count bytes from @buffer into
|
|
the stream. When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_write_all_finish() to get the result of the
|
|
operation.
|
|
|
|
This is the asynchronous version of g_output_stream_write_all().
|
|
|
|
Call g_output_stream_write_all_finish() to collect the result.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
Note that no copy of @buffer will be made, so it must stay valid
|
|
until @callback is called.</doc>
|
|
<source-position filename="goutputstream.h" line="230"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29991">A #GOutputStream</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29992">the buffer containing the data to write</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29993">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29994">the io priority of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29995">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29996">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29997">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_all_finish" c:identifier="g_output_stream_write_all_finish" version="2.44" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30019">Finishes an asynchronous stream write operation started with
|
|
g_output_stream_write_all_async().
|
|
|
|
As a special exception to the normal conventions for functions that
|
|
use #GError, if this function returns %FALSE (and sets @error) then
|
|
@bytes_written will be set to the number of bytes that were
|
|
successfully written before the error was encountered. This
|
|
functionality is only available from C. If you need it from another
|
|
language then you must write your own loop around
|
|
g_output_stream_write_async().</doc>
|
|
<source-position filename="goutputstream.h" line="239"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30037">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30021">a #GOutputStream</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30022">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30023">location to store the number of bytes that was written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_async" c:identifier="g_output_stream_write_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30042">Request an asynchronous write of @count bytes from @buffer into
|
|
the stream. When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_write_finish() to get the result of the
|
|
operation.
|
|
|
|
During an async request no other sync and async calls are allowed,
|
|
and will result in %G_IO_ERROR_PENDING errors.
|
|
|
|
A value of @count larger than %G_MAXSSIZE will cause a
|
|
%G_IO_ERROR_INVALID_ARGUMENT error.
|
|
|
|
On success, the number of bytes written will be passed to the
|
|
@callback. It is not an error if this is not the same as the
|
|
requested size, as it can happen e.g. on a partial I/O error,
|
|
but generally we try to write as many bytes as requested.
|
|
|
|
You are guaranteed that this method will never fail with
|
|
%G_IO_ERROR_WOULD_BLOCK - if @stream can't accept more data, the
|
|
method will just wait until this changes.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.
|
|
|
|
For the synchronous, blocking version of this function, see
|
|
g_output_stream_write().
|
|
|
|
Note that no copy of @buffer will be made, so it must stay valid
|
|
until @callback is called. See g_output_stream_write_bytes_async()
|
|
for a #GBytes version that will automatically hold a reference to
|
|
the contents (without copying) for the duration of the call.</doc>
|
|
<source-position filename="goutputstream.h" line="217"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30044">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30045">the buffer containing the data to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30046">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30047">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30048">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30049">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30050">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_bytes" c:identifier="g_output_stream_write_bytes" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30090">A wrapper function for g_output_stream_write() which takes a
|
|
#GBytes as input. This can be more convenient for use by language
|
|
bindings or in other cases where the refcounted nature of #GBytes
|
|
is helpful over a bare pointer interface.
|
|
|
|
However, note that this function may still perform partial writes,
|
|
just like g_output_stream_write(). If that occurs, to continue
|
|
writing, you will need to create a new #GBytes containing just the
|
|
remaining bytes, using g_bytes_new_from_bytes(). Passing the same
|
|
#GBytes instance multiple times potentially can result in duplicated
|
|
data in the output stream.</doc>
|
|
<source-position filename="goutputstream.h" line="198"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30109">Number of bytes written, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30092">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30093">the #GBytes to write</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30094">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_bytes_async" c:identifier="g_output_stream_write_bytes_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30113">This function is similar to g_output_stream_write_async(), but
|
|
takes a #GBytes as input. Due to the refcounted nature of #GBytes,
|
|
this allows the stream to avoid taking a copy of the data.
|
|
|
|
However, note that this function may still perform partial writes,
|
|
just like g_output_stream_write_async(). If that occurs, to continue
|
|
writing, you will need to create a new #GBytes containing just the
|
|
remaining bytes, using g_bytes_new_from_bytes(). Passing the same
|
|
#GBytes instance multiple times potentially can result in duplicated
|
|
data in the output stream.
|
|
|
|
For the synchronous, blocking version of this function, see
|
|
g_output_stream_write_bytes().</doc>
|
|
<source-position filename="goutputstream.h" line="274"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30115">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="bytes" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30116">The bytes to write</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30117">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30118">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30119">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30120">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_bytes_finish" c:identifier="g_output_stream_write_bytes_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30138">Finishes a stream write-from-#GBytes operation.</doc>
|
|
<source-position filename="goutputstream.h" line="281"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30147">a #gssize containing the number of bytes written to the stream.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30140">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30141">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_finish" c:identifier="g_output_stream_write_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30151">Finishes a stream write operation.</doc>
|
|
<source-position filename="goutputstream.h" line="225"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30160">a #gssize containing the number of bytes written to the stream.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30153">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30154">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writev" c:identifier="g_output_stream_writev" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30164">Tries to write the bytes contained in the @n_vectors @vectors into the
|
|
stream. Will block during the operation.
|
|
|
|
If @n_vectors is 0 or the sum of all bytes in @vectors is 0, returns 0 and
|
|
does nothing.
|
|
|
|
On success, the number of bytes written to the stream is returned.
|
|
It is not an error if this is not the same as the requested size, as it
|
|
can happen e.g. on a partial I/O error, or if there is not enough
|
|
storage in the stream. All writes block until at least one byte
|
|
is written or an error occurs; 0 is never returned (unless
|
|
@n_vectors is 0 or the sum of all bytes in @vectors is 0).
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.
|
|
|
|
Some implementations of g_output_stream_writev() may have limitations on the
|
|
aggregate buffer size, and will return %G_IO_ERROR_INVALID_ARGUMENT if these
|
|
are exceeded. For example, when writing to a local file on UNIX platforms,
|
|
the aggregate buffer size must not exceed %G_MAXSSIZE bytes.</doc>
|
|
<source-position filename="goutputstream.h" line="169"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30198">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30166">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30167">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30168">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30169">location to store the number of bytes that were
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30171">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writev_all" c:identifier="g_output_stream_writev_all" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30203">Tries to write the bytes contained in the @n_vectors @vectors into the
|
|
stream. Will block during the operation.
|
|
|
|
This function is similar to g_output_stream_writev(), except it tries to
|
|
write as many bytes as requested, only stopping on an error.
|
|
|
|
On a successful write of all @n_vectors vectors, %TRUE is returned, and
|
|
@bytes_written is set to the sum of all the sizes of @vectors.
|
|
|
|
If there is an error during the operation %FALSE is returned and @error
|
|
is set to indicate the error status.
|
|
|
|
As a special exception to the normal conventions for functions that
|
|
use #GError, if this function returns %FALSE (and sets @error) then
|
|
@bytes_written will be set to the number of bytes that were
|
|
successfully written before the error was encountered. This
|
|
functionality is only available from C. If you need it from another
|
|
language then you must write your own loop around
|
|
g_output_stream_write().
|
|
|
|
The content of the individual elements of @vectors might be changed by this
|
|
function.</doc>
|
|
<source-position filename="goutputstream.h" line="176"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30236">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30205">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30206">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30207">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30208">location to store the number of bytes that were
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30210">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writev_all_async" c:identifier="g_output_stream_writev_all_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30241">Request an asynchronous write of the bytes contained in the @n_vectors @vectors into
|
|
the stream. When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_writev_all_finish() to get the result of the
|
|
operation.
|
|
|
|
This is the asynchronous version of g_output_stream_writev_all().
|
|
|
|
Call g_output_stream_writev_all_finish() to collect the result.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
Note that no copy of @vectors will be made, so it must stay valid
|
|
until @callback is called. The content of the individual elements
|
|
of @vectors might be changed by this function.</doc>
|
|
<source-position filename="goutputstream.h" line="259"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30243">A #GOutputStream</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30244">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30245">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30246">the I/O priority of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30247">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30248">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30249">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writev_all_finish" c:identifier="g_output_stream_writev_all_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30272">Finishes an asynchronous stream write operation started with
|
|
g_output_stream_writev_all_async().
|
|
|
|
As a special exception to the normal conventions for functions that
|
|
use #GError, if this function returns %FALSE (and sets @error) then
|
|
@bytes_written will be set to the number of bytes that were
|
|
successfully written before the error was encountered. This
|
|
functionality is only available from C. If you need it from another
|
|
language then you must write your own loop around
|
|
g_output_stream_writev_async().</doc>
|
|
<source-position filename="goutputstream.h" line="268"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30290">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30274">a #GOutputStream</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30275">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30276">location to store the number of bytes that were written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writev_async" c:identifier="g_output_stream_writev_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30295">Request an asynchronous write of the bytes contained in @n_vectors @vectors into
|
|
the stream. When the operation is finished @callback will be called.
|
|
You can then call g_output_stream_writev_finish() to get the result of the
|
|
operation.
|
|
|
|
During an async request no other sync and async calls are allowed,
|
|
and will result in %G_IO_ERROR_PENDING errors.
|
|
|
|
On success, the number of bytes written will be passed to the
|
|
@callback. It is not an error if this is not the same as the
|
|
requested size, as it can happen e.g. on a partial I/O error,
|
|
but generally we try to write as many bytes as requested.
|
|
|
|
You are guaranteed that this method will never fail with
|
|
%G_IO_ERROR_WOULD_BLOCK — if @stream can't accept more data, the
|
|
method will just wait until this changes.
|
|
|
|
Any outstanding I/O request with higher priority (lower numerical
|
|
value) will be executed before an outstanding request with lower
|
|
priority. Default priority is %G_PRIORITY_DEFAULT.
|
|
|
|
The asynchronous methods have a default fallback that uses threads
|
|
to implement asynchronicity, so they are optional for inheriting
|
|
classes. However, if you override one you must override all.
|
|
|
|
For the synchronous, blocking version of this function, see
|
|
g_output_stream_writev().
|
|
|
|
Note that no copy of @vectors will be made, so it must stay valid
|
|
until @callback is called.</doc>
|
|
<source-position filename="goutputstream.h" line="245"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30297">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30298">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30299">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30300">the I/O priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30301">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30302">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30303">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writev_finish" c:identifier="g_output_stream_writev_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30340">Finishes a stream writev operation.</doc>
|
|
<source-position filename="goutputstream.h" line="253"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30350">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30342">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30343">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30344">location to store the number of bytes that were written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="OutputStreamPrivate" c:type="GOutputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="OutputStreamClass" c:type="GOutputStreamClass" glib:is-gtype-struct-for="OutputStream">
|
|
<source-position filename="goutputstream.h" line="149"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="write_fn">
|
|
<callback name="write_fn" throws="1">
|
|
<source-position filename="goutputstream.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29951">Number of bytes written, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29924">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29925">the buffer containing the data to write.</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29926">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29927">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="splice">
|
|
<callback name="splice" throws="1">
|
|
<source-position filename="goutputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29850">a #gssize containing the size of the data spliced, or
|
|
-1 if an error occurred. Note that if the number of bytes
|
|
spliced is greater than %G_MAXSSIZE, then that will be
|
|
returned, and there is no way to determine the actual number
|
|
of bytes spliced.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29841">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29842">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29843">a set of #GOutputStreamSpliceFlags.</doc>
|
|
<type name="OutputStreamSpliceFlags" c:type="GOutputStreamSpliceFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29844">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="flush">
|
|
<callback name="flush" throws="1">
|
|
<source-position filename="goutputstream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29728">%TRUE on success, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29714">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29715">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_fn">
|
|
<callback name="close_fn" throws="1">
|
|
<source-position filename="goutputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="write_async">
|
|
<callback name="write_async">
|
|
<source-position filename="goutputstream.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30044">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30045">the buffer containing the data to write.</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30046">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30047">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30048">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30049">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30050">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="write_finish">
|
|
<callback name="write_finish" throws="1">
|
|
<source-position filename="goutputstream.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30160">a #gssize containing the number of bytes written to the stream.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30153">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30154">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="splice_async">
|
|
<callback name="splice_async">
|
|
<source-position filename="goutputstream.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29860">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29861">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29862">a set of #GOutputStreamSpliceFlags.</doc>
|
|
<type name="OutputStreamSpliceFlags" c:type="GOutputStreamSpliceFlags"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29863">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29864">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29865">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29866">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="splice_finish">
|
|
<callback name="splice_finish" throws="1">
|
|
<source-position filename="goutputstream.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29887">a #gssize of the number of bytes spliced. Note that if the
|
|
number of bytes spliced is greater than %G_MAXSSIZE, then that
|
|
will be returned, and there is no way to determine the actual
|
|
number of bytes spliced.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29880">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29881">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="flush_async">
|
|
<callback name="flush_async">
|
|
<source-position filename="goutputstream.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29734">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29735">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29736">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29737">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29738">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="flush_finish">
|
|
<callback name="flush_finish" throws="1">
|
|
<source-position filename="goutputstream.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29759">%TRUE if flush operation succeeded, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29752">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29753">a GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_async">
|
|
<callback name="close_async">
|
|
<source-position filename="goutputstream.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29680">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29681">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29682">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29683">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29684">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="close_finish">
|
|
<callback name="close_finish" throws="1">
|
|
<source-position filename="goutputstream.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29708">%TRUE if stream was successfully closed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29701">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29702">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="writev_fn">
|
|
<callback name="writev_fn" throws="1">
|
|
<source-position filename="goutputstream.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30198">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30166">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30167">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="2" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30168">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30169">location to store the number of bytes that were
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30171">optional cancellable object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="writev_async">
|
|
<callback name="writev_async">
|
|
<source-position filename="goutputstream.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30297">A #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30298">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="2" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30299">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30300">the I/O priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30301">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30302">callback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30303">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="writev_finish">
|
|
<callback name="writev_finish" throws="1">
|
|
<source-position filename="goutputstream.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30350">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30342">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30343">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30344">location to store the number of bytes that were written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="goutputstream.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="goutputstream.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="goutputstream.h" line="146"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved7" introspectable="0">
|
|
<callback name="_g_reserved7">
|
|
<source-position filename="goutputstream.h" line="147"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved8" introspectable="0">
|
|
<callback name="_g_reserved8">
|
|
<source-position filename="goutputstream.h" line="148"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="OutputStreamPrivate" c:type="GOutputStreamPrivate" disguised="1">
|
|
<source-position filename="goutputstream.h" line="49"/>
|
|
</record>
|
|
<bitfield name="OutputStreamSpliceFlags" glib:type-name="GOutputStreamSpliceFlags" glib:get-type="g_output_stream_splice_flags_get_type" c:type="GOutputStreamSpliceFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="640">GOutputStreamSpliceFlags determine how streams should be spliced.</doc>
|
|
<member name="none" value="0" c:identifier="G_OUTPUT_STREAM_SPLICE_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="642">Do not close either stream.</doc>
|
|
</member>
|
|
<member name="close_source" value="1" c:identifier="G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE" glib:nick="close-source">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="643">Close the source stream after
|
|
the splice.</doc>
|
|
</member>
|
|
<member name="close_target" value="2" c:identifier="G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET" glib:nick="close-target">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="645">Close the target stream after
|
|
the splice.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="OutputVector" c:type="GOutputVector" version="2.22">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="493">Structure used for scatter/gather data output.
|
|
You generally pass in an array of #GOutputVectors
|
|
and the operation will use all the buffers as if they were
|
|
one buffer.</doc>
|
|
<source-position filename="giotypes.h" line="510"/>
|
|
<field name="buffer" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="495">Pointer to a buffer of data to read.</doc>
|
|
<type name="gpointer" c:type="gconstpointer"/>
|
|
</field>
|
|
<field name="size" writable="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="496">the size of @buffer.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</field>
|
|
</record>
|
|
<function-macro name="PERMISSION" c:identifier="G_PERMISSION" introspectable="0">
|
|
<source-position filename="gpermission.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PERMISSION_CLASS" c:identifier="G_PERMISSION_CLASS" introspectable="0">
|
|
<source-position filename="gpermission.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PERMISSION_GET_CLASS" c:identifier="G_PERMISSION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gpermission.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="POLLABLE_INPUT_STREAM" c:identifier="G_POLLABLE_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gpollableinputstream.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="POLLABLE_INPUT_STREAM_GET_INTERFACE" c:identifier="G_POLLABLE_INPUT_STREAM_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gpollableinputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="POLLABLE_OUTPUT_STREAM" c:identifier="G_POLLABLE_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gpollableoutputstream.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="POLLABLE_OUTPUT_STREAM_GET_INTERFACE" c:identifier="G_POLLABLE_OUTPUT_STREAM_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gpollableoutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROPERTY_ACTION" c:identifier="G_PROPERTY_ACTION" introspectable="0">
|
|
<source-position filename="gpropertyaction.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY" c:identifier="G_PROXY" introspectable="0">
|
|
<source-position filename="gproxy.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY_ADDRESS" c:identifier="G_PROXY_ADDRESS" introspectable="0">
|
|
<source-position filename="gproxyaddress.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY_ADDRESS_CLASS" c:identifier="G_PROXY_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gproxyaddress.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY_ADDRESS_ENUMERATOR" c:identifier="G_PROXY_ADDRESS_ENUMERATOR" introspectable="0">
|
|
<source-position filename="gproxyaddressenumerator.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY_ADDRESS_ENUMERATOR_CLASS" c:identifier="G_PROXY_ADDRESS_ENUMERATOR_CLASS" introspectable="0">
|
|
<source-position filename="gproxyaddressenumerator.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY_ADDRESS_ENUMERATOR_GET_CLASS" c:identifier="G_PROXY_ADDRESS_ENUMERATOR_GET_CLASS" introspectable="0">
|
|
<source-position filename="gproxyaddressenumerator.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY_ADDRESS_GET_CLASS" c:identifier="G_PROXY_ADDRESS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gproxyaddress.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="PROXY_EXTENSION_POINT_NAME" value="gio-proxy" c:type="G_PROXY_EXTENSION_POINT_NAME" version="2.26">
|
|
<doc xml:space="preserve" filename="gproxy.h" line="39">Extension point for proxy functionality.
|
|
See [Extending GIO][extending-gio].</doc>
|
|
<source-position filename="gproxy.h" line="47"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="PROXY_GET_IFACE" c:identifier="G_PROXY_GET_IFACE" introspectable="0">
|
|
<source-position filename="gproxy.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="PROXY_RESOLVER" c:identifier="G_PROXY_RESOLVER" introspectable="0">
|
|
<source-position filename="gproxyresolver.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="PROXY_RESOLVER_EXTENSION_POINT_NAME" value="gio-proxy-resolver" c:type="G_PROXY_RESOLVER_EXTENSION_POINT_NAME">
|
|
<doc xml:space="preserve" filename="gproxyresolver.h" line="37">Extension point for proxy resolving functionality.
|
|
See [Extending GIO][extending-gio].</doc>
|
|
<source-position filename="gproxyresolver.h" line="43"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="PROXY_RESOLVER_GET_IFACE" c:identifier="G_PROXY_RESOLVER_GET_IFACE" introspectable="0">
|
|
<source-position filename="gproxyresolver.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<enumeration name="PasswordSave" glib:type-name="GPasswordSave" glib:get-type="g_password_save_get_type" c:type="GPasswordSave">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="603">#GPasswordSave is used to indicate the lifespan of a saved password.
|
|
|
|
#Gvfs stores passwords in the Gnome keyring when this flag allows it
|
|
to, and later retrieves it again from there.</doc>
|
|
<member name="never" value="0" c:identifier="G_PASSWORD_SAVE_NEVER" glib:nick="never">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="605">never save a password.</doc>
|
|
</member>
|
|
<member name="for_session" value="1" c:identifier="G_PASSWORD_SAVE_FOR_SESSION" glib:nick="for-session">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="606">save a password for the session.</doc>
|
|
</member>
|
|
<member name="permanently" value="2" c:identifier="G_PASSWORD_SAVE_PERMANENTLY" glib:nick="permanently">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="607">save a password permanently.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="Permission" c:symbol-prefix="permission" c:type="GPermission" parent="GObject.Object" abstract="1" glib:type-name="GPermission" glib:get-type="g_permission_get_type" glib:type-struct="PermissionClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7232">A #GPermission represents the status of the caller's permission to
|
|
perform a certain action.
|
|
|
|
You can query if the action is currently allowed and if it is
|
|
possible to acquire the permission so that the action will be allowed
|
|
in the future.
|
|
|
|
There is also an API to actually acquire the permission and one to
|
|
release it.
|
|
|
|
As an example, a #GPermission might represent the ability for the
|
|
user to write to a #GSettings object. This #GPermission object could
|
|
then be used to decide if it is appropriate to show a "Click here to
|
|
unlock" button in a dialog and to provide the mechanism to invoke
|
|
when that button is clicked.</doc>
|
|
<source-position filename="gpermission.h" line="80"/>
|
|
<virtual-method name="acquire" invoker="acquire" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30355">Attempts to acquire the permission represented by @permission.
|
|
|
|
The precise method by which this happens depends on the permission
|
|
and the underlying authentication mechanism. A simple example is
|
|
that a dialog may appear asking the user to enter their password.
|
|
|
|
You should check with g_permission_get_can_acquire() before calling
|
|
this function.
|
|
|
|
If the permission is acquired then %TRUE is returned. Otherwise,
|
|
%FALSE is returned and @error is set appropriately.
|
|
|
|
This call is blocking, likely for a very long time (in the case that
|
|
user interaction is required). See g_permission_acquire_async() for
|
|
the non-blocking version.</doc>
|
|
<source-position filename="gpermission.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30377">%TRUE if the permission was successfully acquired</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30357">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30358">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="acquire_async" invoker="acquire_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30382">Attempts to acquire the permission represented by @permission.
|
|
|
|
This is the first half of the asynchronous version of
|
|
g_permission_acquire().</doc>
|
|
<source-position filename="gpermission.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30384">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30385">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30386">the #GAsyncReadyCallback to call when done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30387">the user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="acquire_finish" invoker="acquire_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30398">Collects the result of attempting to acquire the permission
|
|
represented by @permission.
|
|
|
|
This is the second half of the asynchronous version of
|
|
g_permission_acquire().</doc>
|
|
<source-position filename="gpermission.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30410">%TRUE if the permission was successfully acquired</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30400">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30401">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="release" invoker="release" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30471">Attempts to release the permission represented by @permission.
|
|
|
|
The precise method by which this happens depends on the permission
|
|
and the underlying authentication mechanism. In most cases the
|
|
permission will be dropped immediately without further action.
|
|
|
|
You should check with g_permission_get_can_release() before calling
|
|
this function.
|
|
|
|
If the permission is released then %TRUE is returned. Otherwise,
|
|
%FALSE is returned and @error is set appropriately.
|
|
|
|
This call is blocking, likely for a very long time (in the case that
|
|
user interaction is required). See g_permission_release_async() for
|
|
the non-blocking version.</doc>
|
|
<source-position filename="gpermission.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30493">%TRUE if the permission was successfully released</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30473">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30474">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="release_async" invoker="release_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30498">Attempts to release the permission represented by @permission.
|
|
|
|
This is the first half of the asynchronous version of
|
|
g_permission_release().</doc>
|
|
<source-position filename="gpermission.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30500">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30501">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30502">the #GAsyncReadyCallback to call when done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30503">the user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="release_finish" invoker="release_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30514">Collects the result of attempting to release the permission
|
|
represented by @permission.
|
|
|
|
This is the second half of the asynchronous version of
|
|
g_permission_release().</doc>
|
|
<source-position filename="gpermission.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30526">%TRUE if the permission was successfully released</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30516">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30517">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="acquire" c:identifier="g_permission_acquire" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30355">Attempts to acquire the permission represented by @permission.
|
|
|
|
The precise method by which this happens depends on the permission
|
|
and the underlying authentication mechanism. A simple example is
|
|
that a dialog may appear asking the user to enter their password.
|
|
|
|
You should check with g_permission_get_can_acquire() before calling
|
|
this function.
|
|
|
|
If the permission is acquired then %TRUE is returned. Otherwise,
|
|
%FALSE is returned and @error is set appropriately.
|
|
|
|
This call is blocking, likely for a very long time (in the case that
|
|
user interaction is required). See g_permission_acquire_async() for
|
|
the non-blocking version.</doc>
|
|
<source-position filename="gpermission.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30377">%TRUE if the permission was successfully acquired</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30357">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30358">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="acquire_async" c:identifier="g_permission_acquire_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30382">Attempts to acquire the permission represented by @permission.
|
|
|
|
This is the first half of the asynchronous version of
|
|
g_permission_acquire().</doc>
|
|
<source-position filename="gpermission.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30384">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30385">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30386">the #GAsyncReadyCallback to call when done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30387">the user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="acquire_finish" c:identifier="g_permission_acquire_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30398">Collects the result of attempting to acquire the permission
|
|
represented by @permission.
|
|
|
|
This is the second half of the asynchronous version of
|
|
g_permission_acquire().</doc>
|
|
<source-position filename="gpermission.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30410">%TRUE if the permission was successfully acquired</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30400">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30401">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_allowed" c:identifier="g_permission_get_allowed" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30415">Gets the value of the 'allowed' property. This property is %TRUE if
|
|
the caller currently has permission to perform the action that
|
|
@permission represents the permission to perform.</doc>
|
|
<source-position filename="gpermission.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30423">the value of the 'allowed' property</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30417">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_can_acquire" c:identifier="g_permission_get_can_acquire" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30428">Gets the value of the 'can-acquire' property. This property is %TRUE
|
|
if it is generally possible to acquire the permission by calling
|
|
g_permission_acquire().</doc>
|
|
<source-position filename="gpermission.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30436">the value of the 'can-acquire' property</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30430">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_can_release" c:identifier="g_permission_get_can_release" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30441">Gets the value of the 'can-release' property. This property is %TRUE
|
|
if it is generally possible to release the permission by calling
|
|
g_permission_release().</doc>
|
|
<source-position filename="gpermission.h" line="117"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30449">the value of the 'can-release' property</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30443">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="impl_update" c:identifier="g_permission_impl_update" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30454">This function is called by the #GPermission implementation to update
|
|
the properties of the permission. You should never call this
|
|
function except from a #GPermission implementation.
|
|
|
|
GObject notify signals are generated, as appropriate.</doc>
|
|
<source-position filename="gpermission.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30456">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="allowed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30457">the new value for the 'allowed' property</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="can_acquire" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30458">the new value for the 'can-acquire' property</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="can_release" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30459">the new value for the 'can-release' property</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="release" c:identifier="g_permission_release" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30471">Attempts to release the permission represented by @permission.
|
|
|
|
The precise method by which this happens depends on the permission
|
|
and the underlying authentication mechanism. In most cases the
|
|
permission will be dropped immediately without further action.
|
|
|
|
You should check with g_permission_get_can_release() before calling
|
|
this function.
|
|
|
|
If the permission is released then %TRUE is returned. Otherwise,
|
|
%FALSE is returned and @error is set appropriately.
|
|
|
|
This call is blocking, likely for a very long time (in the case that
|
|
user interaction is required). See g_permission_release_async() for
|
|
the non-blocking version.</doc>
|
|
<source-position filename="gpermission.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30493">%TRUE if the permission was successfully released</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30473">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30474">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="release_async" c:identifier="g_permission_release_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30498">Attempts to release the permission represented by @permission.
|
|
|
|
This is the first half of the asynchronous version of
|
|
g_permission_release().</doc>
|
|
<source-position filename="gpermission.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30500">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30501">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30502">the #GAsyncReadyCallback to call when done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30503">the user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="release_finish" c:identifier="g_permission_release_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30514">Collects the result of attempting to release the permission
|
|
represented by @permission.
|
|
|
|
This is the second half of the asynchronous version of
|
|
g_permission_release().</doc>
|
|
<source-position filename="gpermission.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30526">%TRUE if the permission was successfully released</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30516">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30517">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="allowed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2599">%TRUE if the caller currently has permission to perform the action that
|
|
@permission represents the permission to perform.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="can-acquire" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2607">%TRUE if it is generally possible to acquire the permission by calling
|
|
g_permission_acquire().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="can-release" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2615">%TRUE if it is generally possible to release the permission by calling
|
|
g_permission_release().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="PermissionPrivate" c:type="GPermissionPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="PermissionClass" c:type="GPermissionClass" glib:is-gtype-struct-for="Permission">
|
|
<source-position filename="gpermission.h" line="80"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="acquire">
|
|
<callback name="acquire" throws="1">
|
|
<source-position filename="gpermission.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30377">%TRUE if the permission was successfully acquired</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30357">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30358">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="acquire_async">
|
|
<callback name="acquire_async">
|
|
<source-position filename="gpermission.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30384">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30385">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30386">the #GAsyncReadyCallback to call when done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30387">the user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="acquire_finish">
|
|
<callback name="acquire_finish" throws="1">
|
|
<source-position filename="gpermission.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30410">%TRUE if the permission was successfully acquired</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30400">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30401">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="release">
|
|
<callback name="release" throws="1">
|
|
<source-position filename="gpermission.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30493">%TRUE if the permission was successfully released</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30473">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30474">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="release_async">
|
|
<callback name="release_async">
|
|
<source-position filename="gpermission.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30500">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30501">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30502">the #GAsyncReadyCallback to call when done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30503">the user data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="release_finish">
|
|
<callback name="release_finish" throws="1">
|
|
<source-position filename="gpermission.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30526">%TRUE if the permission was successfully released</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="permission" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30516">a #GPermission instance</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30517">the #GAsyncResult given to the #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="reserved">
|
|
<array zero-terminated="0" fixed-size="16">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="PermissionPrivate" c:type="GPermissionPrivate" disguised="1">
|
|
<source-position filename="gpermission.h" line="43"/>
|
|
</record>
|
|
<interface name="PollableInputStream" c:symbol-prefix="pollable_input_stream" c:type="GPollableInputStream" version="2.28" glib:type-name="GPollableInputStream" glib:get-type="g_pollable_input_stream_get_type" glib:type-struct="PollableInputStreamInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7257">#GPollableInputStream is implemented by #GInputStreams that
|
|
can be polled for readiness to read. This can be used when
|
|
interfacing with a non-GIO API that expects
|
|
UNIX-file-descriptor-style asynchronous I/O rather than GIO-style.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="80"/>
|
|
<prerequisite name="InputStream"/>
|
|
<virtual-method name="can_poll" invoker="can_poll" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30531">Checks if @stream is actually pollable. Some classes may implement
|
|
#GPollableInputStream but have only certain instances of that class
|
|
be pollable. If this method returns %FALSE, then the behavior of
|
|
other #GPollableInputStream methods is undefined.
|
|
|
|
For any given stream, the value returned by this method is constant;
|
|
a stream cannot switch from pollable to non-pollable or vice versa.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30543">%TRUE if @stream is pollable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30533">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_source" invoker="create_source" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30548">Creates a #GSource that triggers when @stream can be read, or
|
|
@cancellable is triggered or an error occurs. The callback on the
|
|
source is of the #GPollableSourceFunc type.
|
|
|
|
As with g_pollable_input_stream_is_readable(), it is possible that
|
|
the stream may not actually be readable even after the source
|
|
triggers, so you should use g_pollable_input_stream_read_nonblocking()
|
|
rather than g_input_stream_read() from the callback.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30562">a new #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30550">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30551">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_readable" invoker="is_readable" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30567">Checks if @stream can be read.
|
|
|
|
Note that some stream types may not be able to implement this 100%
|
|
reliably, and it is possible that a call to g_input_stream_read()
|
|
after this returns %TRUE would still block. To guarantee
|
|
non-blocking behavior, you should always use
|
|
g_pollable_input_stream_read_nonblocking(), which will return a
|
|
%G_IO_ERROR_WOULD_BLOCK error rather than blocking.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30580">%TRUE if @stream is readable, %FALSE if not. If an error
|
|
has occurred on @stream, this will result in
|
|
g_pollable_input_stream_is_readable() returning %TRUE, and the
|
|
next attempt to read will return the error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30569">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_nonblocking" invoker="read_nonblocking" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30588">Attempts to read up to @count bytes from @stream into @buffer, as
|
|
with g_input_stream_read(). If @stream is not currently readable,
|
|
this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
|
|
use g_pollable_input_stream_create_source() to create a #GSource
|
|
that will be triggered when @stream is readable.
|
|
|
|
Note that since this method never blocks, you cannot actually
|
|
use @cancellable to cancel it. However, it will return an error
|
|
if @cancellable has already been cancelled when you call, which
|
|
may happen if you call this method after a source triggers due
|
|
to having been cancelled.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30609">the number of bytes read, or -1 on error (including
|
|
%G_IO_ERROR_WOULD_BLOCK).</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30590">a #GPollableInputStream</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30591">a buffer to
|
|
read data into (which should be at least @count bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30593">the number of bytes you want to read</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="can_poll" c:identifier="g_pollable_input_stream_can_poll" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30531">Checks if @stream is actually pollable. Some classes may implement
|
|
#GPollableInputStream but have only certain instances of that class
|
|
be pollable. If this method returns %FALSE, then the behavior of
|
|
other #GPollableInputStream methods is undefined.
|
|
|
|
For any given stream, the value returned by this method is constant;
|
|
a stream cannot switch from pollable to non-pollable or vice versa.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30543">%TRUE if @stream is pollable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30533">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_source" c:identifier="g_pollable_input_stream_create_source" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30548">Creates a #GSource that triggers when @stream can be read, or
|
|
@cancellable is triggered or an error occurs. The callback on the
|
|
source is of the #GPollableSourceFunc type.
|
|
|
|
As with g_pollable_input_stream_is_readable(), it is possible that
|
|
the stream may not actually be readable even after the source
|
|
triggers, so you should use g_pollable_input_stream_read_nonblocking()
|
|
rather than g_input_stream_read() from the callback.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="91"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30562">a new #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30550">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30551">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_readable" c:identifier="g_pollable_input_stream_is_readable" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30567">Checks if @stream can be read.
|
|
|
|
Note that some stream types may not be able to implement this 100%
|
|
reliably, and it is possible that a call to g_input_stream_read()
|
|
after this returns %TRUE would still block. To guarantee
|
|
non-blocking behavior, you should always use
|
|
g_pollable_input_stream_read_nonblocking(), which will return a
|
|
%G_IO_ERROR_WOULD_BLOCK error rather than blocking.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30580">%TRUE if @stream is readable, %FALSE if not. If an error
|
|
has occurred on @stream, this will result in
|
|
g_pollable_input_stream_is_readable() returning %TRUE, and the
|
|
next attempt to read will return the error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30569">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="read_nonblocking" c:identifier="g_pollable_input_stream_read_nonblocking" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30588">Attempts to read up to @count bytes from @stream into @buffer, as
|
|
with g_input_stream_read(). If @stream is not currently readable,
|
|
this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
|
|
use g_pollable_input_stream_create_source() to create a #GSource
|
|
that will be triggered when @stream is readable.
|
|
|
|
Note that since this method never blocks, you cannot actually
|
|
use @cancellable to cancel it. However, it will return an error
|
|
if @cancellable has already been cancelled when you call, which
|
|
may happen if you call this method after a source triggers due
|
|
to having been cancelled.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30609">the number of bytes read, or -1 on error (including
|
|
%G_IO_ERROR_WOULD_BLOCK).</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30590">a #GPollableInputStream</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30591">a buffer to
|
|
read data into (which should be at least @count bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30593">the number of bytes you want to read</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30594">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="PollableInputStreamInterface" c:type="GPollableInputStreamInterface" glib:is-gtype-struct-for="PollableInputStream" version="2.28">
|
|
<doc xml:space="preserve" filename="gpollableinputstream.h" line="44">The interface for pollable input streams.
|
|
|
|
The default implementation of @can_poll always returns %TRUE.
|
|
|
|
The default implementation of @read_nonblocking calls
|
|
g_pollable_input_stream_is_readable(), and then calls
|
|
g_input_stream_read() if it returns %TRUE. This means you only need
|
|
to override it if it is possible that your @is_readable
|
|
implementation may return %TRUE when the stream is not actually
|
|
readable.</doc>
|
|
<source-position filename="gpollableinputstream.h" line="80"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gpollableinputstream.h" line="46">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="can_poll">
|
|
<callback name="can_poll">
|
|
<source-position filename="gpollableinputstream.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30543">%TRUE if @stream is pollable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30533">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_readable">
|
|
<callback name="is_readable">
|
|
<source-position filename="gpollableinputstream.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30580">%TRUE if @stream is readable, %FALSE if not. If an error
|
|
has occurred on @stream, this will result in
|
|
g_pollable_input_stream_is_readable() returning %TRUE, and the
|
|
next attempt to read will return the error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30569">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_source">
|
|
<callback name="create_source">
|
|
<source-position filename="gpollableinputstream.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30562">a new #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30550">a #GPollableInputStream.</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30551">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="read_nonblocking">
|
|
<callback name="read_nonblocking" throws="1">
|
|
<source-position filename="gpollableinputstream.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30609">the number of bytes read, or -1 on error (including
|
|
%G_IO_ERROR_WOULD_BLOCK).</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30590">a #GPollableInputStream</doc>
|
|
<type name="PollableInputStream" c:type="GPollableInputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30591">a buffer to
|
|
read data into (which should be at least @count bytes long).</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30593">the number of bytes you want to read</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<interface name="PollableOutputStream" c:symbol-prefix="pollable_output_stream" c:type="GPollableOutputStream" version="2.28" glib:type-name="GPollableOutputStream" glib:get-type="g_pollable_output_stream_get_type" glib:type-struct="PollableOutputStreamInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7272">#GPollableOutputStream is implemented by #GOutputStreams that
|
|
can be polled for readiness to write. This can be used when
|
|
interfacing with a non-GIO API that expects
|
|
UNIX-file-descriptor-style asynchronous I/O rather than GIO-style.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="93"/>
|
|
<prerequisite name="OutputStream"/>
|
|
<virtual-method name="can_poll" invoker="can_poll" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30614">Checks if @stream is actually pollable. Some classes may implement
|
|
#GPollableOutputStream but have only certain instances of that
|
|
class be pollable. If this method returns %FALSE, then the behavior
|
|
of other #GPollableOutputStream methods is undefined.
|
|
|
|
For any given stream, the value returned by this method is constant;
|
|
a stream cannot switch from pollable to non-pollable or vice versa.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30626">%TRUE if @stream is pollable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30616">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="create_source" invoker="create_source" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30631">Creates a #GSource that triggers when @stream can be written, or
|
|
@cancellable is triggered or an error occurs. The callback on the
|
|
source is of the #GPollableSourceFunc type.
|
|
|
|
As with g_pollable_output_stream_is_writable(), it is possible that
|
|
the stream may not actually be writable even after the source
|
|
triggers, so you should use g_pollable_output_stream_write_nonblocking()
|
|
rather than g_output_stream_write() from the callback.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="82"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30645">a new #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30633">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30634">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_writable" invoker="is_writable" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30650">Checks if @stream can be written.
|
|
|
|
Note that some stream types may not be able to implement this 100%
|
|
reliably, and it is possible that a call to g_output_stream_write()
|
|
after this returns %TRUE would still block. To guarantee
|
|
non-blocking behavior, you should always use
|
|
g_pollable_output_stream_write_nonblocking(), which will return a
|
|
%G_IO_ERROR_WOULD_BLOCK error rather than blocking.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30663">%TRUE if @stream is writable, %FALSE if not. If an error
|
|
has occurred on @stream, this will result in
|
|
g_pollable_output_stream_is_writable() returning %TRUE, and the
|
|
next attempt to write will return the error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30652">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="write_nonblocking" invoker="write_nonblocking" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30671">Attempts to write up to @count bytes from @buffer to @stream, as
|
|
with g_output_stream_write(). If @stream is not currently writable,
|
|
this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
|
|
use g_pollable_output_stream_create_source() to create a #GSource
|
|
that will be triggered when @stream is writable.
|
|
|
|
Note that since this method never blocks, you cannot actually
|
|
use @cancellable to cancel it. However, it will return an error
|
|
if @cancellable has already been cancelled when you call, which
|
|
may happen if you call this method after a source triggers due
|
|
to having been cancelled.
|
|
|
|
Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying
|
|
transports like D/TLS require that you re-send the same @buffer and
|
|
@count in the next write call.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30696">the number of bytes written, or -1 on error (including
|
|
%G_IO_ERROR_WOULD_BLOCK).</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30673">a #GPollableOutputStream</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30674">a buffer to write
|
|
data from</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30676">the number of bytes you want to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="writev_nonblocking" invoker="writev_nonblocking" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30701">Attempts to write the bytes contained in the @n_vectors @vectors to @stream,
|
|
as with g_output_stream_writev(). If @stream is not currently writable,
|
|
this will immediately return %@G_POLLABLE_RETURN_WOULD_BLOCK, and you can
|
|
use g_pollable_output_stream_create_source() to create a #GSource
|
|
that will be triggered when @stream is writable. @error will *not* be
|
|
set in that case.
|
|
|
|
Note that since this method never blocks, you cannot actually
|
|
use @cancellable to cancel it. However, it will return an error
|
|
if @cancellable has already been cancelled when you call, which
|
|
may happen if you call this method after a source triggers due
|
|
to having been cancelled.
|
|
|
|
Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying
|
|
transports like D/TLS require that you re-send the same @vectors and
|
|
@n_vectors in the next write call.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30728">%@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK
|
|
if the stream is not currently writable (and @error is *not* set), or
|
|
%G_POLLABLE_RETURN_FAILED if there was an error in which case @error will
|
|
be set.</doc>
|
|
<type name="PollableReturn" c:type="GPollableReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30703">a #GPollableOutputStream</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30704">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30705">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30706">location to store the number of bytes that were
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="can_poll" c:identifier="g_pollable_output_stream_can_poll" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30614">Checks if @stream is actually pollable. Some classes may implement
|
|
#GPollableOutputStream but have only certain instances of that
|
|
class be pollable. If this method returns %FALSE, then the behavior
|
|
of other #GPollableOutputStream methods is undefined.
|
|
|
|
For any given stream, the value returned by this method is constant;
|
|
a stream cannot switch from pollable to non-pollable or vice versa.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30626">%TRUE if @stream is pollable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30616">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_source" c:identifier="g_pollable_output_stream_create_source" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30631">Creates a #GSource that triggers when @stream can be written, or
|
|
@cancellable is triggered or an error occurs. The callback on the
|
|
source is of the #GPollableSourceFunc type.
|
|
|
|
As with g_pollable_output_stream_is_writable(), it is possible that
|
|
the stream may not actually be writable even after the source
|
|
triggers, so you should use g_pollable_output_stream_write_nonblocking()
|
|
rather than g_output_stream_write() from the callback.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="104"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30645">a new #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30633">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30634">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_writable" c:identifier="g_pollable_output_stream_is_writable" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30650">Checks if @stream can be written.
|
|
|
|
Note that some stream types may not be able to implement this 100%
|
|
reliably, and it is possible that a call to g_output_stream_write()
|
|
after this returns %TRUE would still block. To guarantee
|
|
non-blocking behavior, you should always use
|
|
g_pollable_output_stream_write_nonblocking(), which will return a
|
|
%G_IO_ERROR_WOULD_BLOCK error rather than blocking.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30663">%TRUE if @stream is writable, %FALSE if not. If an error
|
|
has occurred on @stream, this will result in
|
|
g_pollable_output_stream_is_writable() returning %TRUE, and the
|
|
next attempt to write will return the error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30652">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="write_nonblocking" c:identifier="g_pollable_output_stream_write_nonblocking" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30671">Attempts to write up to @count bytes from @buffer to @stream, as
|
|
with g_output_stream_write(). If @stream is not currently writable,
|
|
this will immediately return %G_IO_ERROR_WOULD_BLOCK, and you can
|
|
use g_pollable_output_stream_create_source() to create a #GSource
|
|
that will be triggered when @stream is writable.
|
|
|
|
Note that since this method never blocks, you cannot actually
|
|
use @cancellable to cancel it. However, it will return an error
|
|
if @cancellable has already been cancelled when you call, which
|
|
may happen if you call this method after a source triggers due
|
|
to having been cancelled.
|
|
|
|
Also note that if %G_IO_ERROR_WOULD_BLOCK is returned some underlying
|
|
transports like D/TLS require that you re-send the same @buffer and
|
|
@count in the next write call.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30696">the number of bytes written, or -1 on error (including
|
|
%G_IO_ERROR_WOULD_BLOCK).</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30673">a #GPollableOutputStream</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30674">a buffer to write
|
|
data from</doc>
|
|
<array length="1" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30676">the number of bytes you want to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30677">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writev_nonblocking" c:identifier="g_pollable_output_stream_writev_nonblocking" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30701">Attempts to write the bytes contained in the @n_vectors @vectors to @stream,
|
|
as with g_output_stream_writev(). If @stream is not currently writable,
|
|
this will immediately return %@G_POLLABLE_RETURN_WOULD_BLOCK, and you can
|
|
use g_pollable_output_stream_create_source() to create a #GSource
|
|
that will be triggered when @stream is writable. @error will *not* be
|
|
set in that case.
|
|
|
|
Note that since this method never blocks, you cannot actually
|
|
use @cancellable to cancel it. However, it will return an error
|
|
if @cancellable has already been cancelled when you call, which
|
|
may happen if you call this method after a source triggers due
|
|
to having been cancelled.
|
|
|
|
Also note that if %G_POLLABLE_RETURN_WOULD_BLOCK is returned some underlying
|
|
transports like D/TLS require that you re-send the same @vectors and
|
|
@n_vectors in the next write call.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30728">%@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK
|
|
if the stream is not currently writable (and @error is *not* set), or
|
|
%G_POLLABLE_RETURN_FAILED if there was an error in which case @error will
|
|
be set.</doc>
|
|
<type name="PollableReturn" c:type="GPollableReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30703">a #GPollableOutputStream</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30704">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30705">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30706">location to store the number of bytes that were
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30708">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="PollableOutputStreamInterface" c:type="GPollableOutputStreamInterface" glib:is-gtype-struct-for="PollableOutputStream" version="2.28">
|
|
<doc xml:space="preserve" filename="gpollableoutputstream.h" line="44">The interface for pollable output streams.
|
|
|
|
The default implementation of @can_poll always returns %TRUE.
|
|
|
|
The default implementation of @write_nonblocking calls
|
|
g_pollable_output_stream_is_writable(), and then calls
|
|
g_output_stream_write() if it returns %TRUE. This means you only
|
|
need to override it if it is possible that your @is_writable
|
|
implementation may return %TRUE when the stream is not actually
|
|
writable.
|
|
|
|
The default implementation of @writev_nonblocking calls
|
|
g_pollable_output_stream_write_nonblocking() for each vector, and converts
|
|
its return value and error (if set) to a #GPollableReturn. You should
|
|
override this where possible to avoid having to allocate a #GError to return
|
|
%G_IO_ERROR_WOULD_BLOCK.</doc>
|
|
<source-position filename="gpollableoutputstream.h" line="93"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gpollableoutputstream.h" line="46">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="can_poll">
|
|
<callback name="can_poll">
|
|
<source-position filename="gpollableoutputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30626">%TRUE if @stream is pollable, %FALSE if not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30616">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_writable">
|
|
<callback name="is_writable">
|
|
<source-position filename="gpollableoutputstream.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30663">%TRUE if @stream is writable, %FALSE if not. If an error
|
|
has occurred on @stream, this will result in
|
|
g_pollable_output_stream_is_writable() returning %TRUE, and the
|
|
next attempt to write will return the error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30652">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_source">
|
|
<callback name="create_source">
|
|
<source-position filename="gpollableoutputstream.h" line="82"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30645">a new #GSource</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30633">a #GPollableOutputStream.</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30634">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="write_nonblocking">
|
|
<callback name="write_nonblocking" throws="1">
|
|
<source-position filename="gpollableoutputstream.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30696">the number of bytes written, or -1 on error (including
|
|
%G_IO_ERROR_WOULD_BLOCK).</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30673">a #GPollableOutputStream</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30674">a buffer to write
|
|
data from</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30676">the number of bytes you want to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="writev_nonblocking">
|
|
<callback name="writev_nonblocking" throws="1">
|
|
<source-position filename="gpollableoutputstream.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30728">%@G_POLLABLE_RETURN_OK on success, %G_POLLABLE_RETURN_WOULD_BLOCK
|
|
if the stream is not currently writable (and @error is *not* set), or
|
|
%G_POLLABLE_RETURN_FAILED if there was an error in which case @error will
|
|
be set.</doc>
|
|
<type name="PollableReturn" c:type="GPollableReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30703">a #GPollableOutputStream</doc>
|
|
<type name="PollableOutputStream" c:type="GPollableOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30704">the buffer containing the #GOutputVectors to write.</doc>
|
|
<array length="2" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30705">the number of vectors to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30706">location to store the number of bytes that were
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<enumeration name="PollableReturn" version="2.60" glib:type-name="GPollableReturn" glib:get-type="g_pollable_return_get_type" c:type="GPollableReturn">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1943">Return value for various IO operations that signal errors via the
|
|
return value and not necessarily via a #GError.
|
|
|
|
This enum exists to be able to return errors to callers without having to
|
|
allocate a #GError. Allocating #GErrors can be quite expensive for
|
|
regularly happening errors like %G_IO_ERROR_WOULD_BLOCK.
|
|
|
|
In case of %G_POLLABLE_RETURN_FAILED a #GError should be set for the
|
|
operation to give details about the error that happened.</doc>
|
|
<member name="failed" value="0" c:identifier="G_POLLABLE_RETURN_FAILED" glib:nick="failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1945">Generic error condition for when an operation fails.</doc>
|
|
</member>
|
|
<member name="ok" value="1" c:identifier="G_POLLABLE_RETURN_OK" glib:nick="ok">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1946">The operation was successfully finished.</doc>
|
|
</member>
|
|
<member name="would_block" value="-27" c:identifier="G_POLLABLE_RETURN_WOULD_BLOCK" glib:nick="would-block">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1947">The operation would block.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<callback name="PollableSourceFunc" c:type="GPollableSourceFunc" version="2.28">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="582">This is the function type of the callback used for the #GSource
|
|
returned by g_pollable_input_stream_create_source() and
|
|
g_pollable_output_stream_create_source().</doc>
|
|
<source-position filename="giotypes.h" line="595"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="591">it should return %FALSE if the source should be removed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pollable_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="584">the #GPollableInputStream or #GPollableOutputStream</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="585">data passed in by the user.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="PropertyAction" c:symbol-prefix="property_action" c:type="GPropertyAction" version="2.38" parent="GObject.Object" glib:type-name="GPropertyAction" glib:get-type="g_property_action_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7297">A #GPropertyAction is a way to get a #GAction with a state value
|
|
reflecting and controlling the value of a #GObject property.
|
|
|
|
The state of the action will correspond to the value of the property.
|
|
Changing it will change the property (assuming the requested value
|
|
matches the requirements as specified in the #GParamSpec).
|
|
|
|
Only the most common types are presently supported. Booleans are
|
|
mapped to booleans, strings to strings, signed/unsigned integers to
|
|
int32/uint32 and floats and doubles to doubles.
|
|
|
|
If the property is an enum then the state will be string-typed and
|
|
conversion will automatically be performed between the enum value and
|
|
"nick" string as per the #GEnumValue table.
|
|
|
|
Flags types are not currently supported.
|
|
|
|
Properties of object types, boxed types and pointer types are not
|
|
supported and probably never will be.
|
|
|
|
Properties of #GVariant types are not currently supported.
|
|
|
|
If the property is boolean-valued then the action will have a NULL
|
|
parameter type, and activating the action (with no parameter) will
|
|
toggle the value of the property.
|
|
|
|
In all other cases, the parameter type will correspond to the type of
|
|
the property.
|
|
|
|
The general idea here is to reduce the number of locations where a
|
|
particular piece of state is kept (and therefore has to be synchronised
|
|
between). #GPropertyAction does not have a separate state that is kept
|
|
in sync with the property value -- its state is the property value.
|
|
|
|
For example, it might be useful to create a #GAction corresponding to
|
|
the "visible-child-name" property of a #GtkStack so that the current
|
|
page can be switched from a menu. The active radio indication in the
|
|
menu is then directly determined from the active page of the
|
|
#GtkStack.
|
|
|
|
An anti-example would be binding the "active-id" property on a
|
|
#GtkComboBox. This is because the state of the combobox itself is
|
|
probably uninteresting and is actually being used to control
|
|
something else.
|
|
|
|
Another anti-example would be to bind to the "visible-child-name"
|
|
property of a #GtkStack if this value is actually stored in
|
|
#GSettings. In that case, the real source of the value is
|
|
#GSettings. If you want a #GAction to control a setting stored in
|
|
#GSettings, see g_settings_create_action() instead, and possibly
|
|
combine its use with g_settings_bind().</doc>
|
|
<implements name="Action"/>
|
|
<constructor name="new" c:identifier="g_property_action_new" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30855">Creates a #GAction corresponding to the value of property
|
|
@property_name on @object.
|
|
|
|
The property must be existent and readable and writable (and not
|
|
construct-only).
|
|
|
|
This function takes a reference on @object and doesn't release it
|
|
until the action is destroyed.</doc>
|
|
<source-position filename="gpropertyaction.h" line="41"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30871">a new #GPropertyAction</doc>
|
|
<type name="PropertyAction" c:type="GPropertyAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30857">the name of the action to create</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30858">the object that has the property
|
|
to wrap</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="property_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30860">the name of the property</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<property name="enabled" version="2.38" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2632">If @action is currently enabled.
|
|
|
|
If the action is disabled then calls to g_action_activate() and
|
|
g_action_change_state() have no effect.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="invert-boolean" version="2.46" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2644">If %TRUE, the state of the action will be the negation of the
|
|
property value, provided the property is boolean.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="name" version="2.38" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2654">The name of the action. This is mostly meaningful for identifying
|
|
the action once it has been added to a #GActionMap.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="object" version="2.38" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2664">The object to wrap a property on.
|
|
|
|
The object must be a non-%NULL #GObject with properties.</doc>
|
|
<type name="GObject.Object"/>
|
|
</property>
|
|
<property name="parameter-type" version="2.38" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2675">The type of the parameter that must be given when activating the
|
|
action.</doc>
|
|
<type name="GLib.VariantType"/>
|
|
</property>
|
|
<property name="property-name" version="2.38" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2685">The name of the property to wrap on the object.
|
|
|
|
The property must exist on the passed-in object and it must be
|
|
readable and writable (and not construct-only).</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="state" version="2.38" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2697">The state of the action, or %NULL if the action is stateless.</doc>
|
|
<type name="GLib.Variant"/>
|
|
</property>
|
|
<property name="state-type" version="2.38" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2706">The #GVariantType of the state that the action has, or %NULL if the
|
|
action is stateless.</doc>
|
|
<type name="GLib.VariantType"/>
|
|
</property>
|
|
</class>
|
|
<interface name="Proxy" c:symbol-prefix="proxy" c:type="GProxy" version="2.26" glib:type-name="GProxy" glib:get-type="g_proxy_get_type" glib:type-struct="ProxyInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7359">A #GProxy handles connecting to a remote host via a given type of
|
|
proxy server. It is implemented by the 'gio-proxy' extension point.
|
|
The extensions are named after their proxy protocol name. As an
|
|
example, a SOCKS5 proxy implementation can be retrieved with the
|
|
name 'socks5' using the function
|
|
g_io_extension_point_get_extension_by_name().</doc>
|
|
<source-position filename="gproxy.h" line="95"/>
|
|
<function name="get_default_for_protocol" c:identifier="g_proxy_get_default_for_protocol" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31030">Find the `gio-proxy` extension point for a proxy implementation that supports
|
|
the specified protocol.</doc>
|
|
<source-position filename="gproxy.h" line="101"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31037">return a #GProxy or NULL if protocol
|
|
is not supported.</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31032">the proxy protocol name (e.g. http, socks, etc)</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="connect" invoker="connect" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30982">Given @connection to communicate with a proxy (eg, a
|
|
#GSocketConnection that is connected to the proxy server), this
|
|
does the necessary handshake to connect to @proxy_address, and if
|
|
required, wraps the #GIOStream to handle proxy payload.</doc>
|
|
<source-position filename="gproxy.h" line="77"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30995">a #GIOStream that will replace @connection. This might
|
|
be the same as @connection, in which case a reference
|
|
will be added.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30984">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30985">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="proxy_address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30986">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30987">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="connect_async" invoker="connect_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31002">Asynchronous version of g_proxy_connect().</doc>
|
|
<source-position filename="gproxy.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31004">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31005">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="proxy_address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31006">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31007">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31008">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31009">callback data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="connect_finish" invoker="connect_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31017">See g_proxy_connect().</doc>
|
|
<source-position filename="gproxy.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31025">a #GIOStream.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31019">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31020">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="supports_hostname" invoker="supports_hostname" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31128">Some proxy protocols expect to be passed a hostname, which they
|
|
will resolve to an IP address themselves. Others, like SOCKS4, do
|
|
not allow this. This function will return %FALSE if @proxy is
|
|
implementing such a protocol. When %FALSE is returned, the caller
|
|
should resolve the destination hostname first, and then pass a
|
|
#GProxyAddress containing the stringified IP address to
|
|
g_proxy_connect() or g_proxy_connect_async().</doc>
|
|
<source-position filename="gproxy.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31140">%TRUE if hostname resolution is supported.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31130">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="connect" c:identifier="g_proxy_connect" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30982">Given @connection to communicate with a proxy (eg, a
|
|
#GSocketConnection that is connected to the proxy server), this
|
|
does the necessary handshake to connect to @proxy_address, and if
|
|
required, wraps the #GIOStream to handle proxy payload.</doc>
|
|
<source-position filename="gproxy.h" line="104"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30995">a #GIOStream that will replace @connection. This might
|
|
be the same as @connection, in which case a reference
|
|
will be added.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30984">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30985">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="proxy_address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30986">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30987">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_async" c:identifier="g_proxy_connect_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31002">Asynchronous version of g_proxy_connect().</doc>
|
|
<source-position filename="gproxy.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31004">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31005">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="proxy_address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31006">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31007">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31008">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31009">callback data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_finish" c:identifier="g_proxy_connect_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31017">See g_proxy_connect().</doc>
|
|
<source-position filename="gproxy.h" line="119"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31025">a #GIOStream.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31019">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31020">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="supports_hostname" c:identifier="g_proxy_supports_hostname" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31128">Some proxy protocols expect to be passed a hostname, which they
|
|
will resolve to an IP address themselves. Others, like SOCKS4, do
|
|
not allow this. This function will return %FALSE if @proxy is
|
|
implementing such a protocol. When %FALSE is returned, the caller
|
|
should resolve the destination hostname first, and then pass a
|
|
#GProxyAddress containing the stringified IP address to
|
|
g_proxy_connect() or g_proxy_connect_async().</doc>
|
|
<source-position filename="gproxy.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31140">%TRUE if hostname resolution is supported.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31130">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<class name="ProxyAddress" c:symbol-prefix="proxy_address" c:type="GProxyAddress" version="2.26" parent="InetSocketAddress" glib:type-name="GProxyAddress" glib:get-type="g_proxy_address_get_type" glib:type-struct="ProxyAddressClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7375">Support for proxied #GInetSocketAddress.</doc>
|
|
<source-position filename="gproxyaddress.h" line="53"/>
|
|
<implements name="SocketConnectable"/>
|
|
<constructor name="new" c:identifier="g_proxy_address_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30958">Creates a new #GProxyAddress for @inetaddr with @protocol that should
|
|
tunnel through @dest_hostname and @dest_port.
|
|
|
|
(Note that this method doesn't set the #GProxyAddress:uri or
|
|
#GProxyAddress:destination-protocol fields; use g_object_new()
|
|
directly if you want to set those.)</doc>
|
|
<source-position filename="gproxyaddress.h" line="60"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30977">a new #GProxyAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="inetaddr" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30960">The proxy server #GInetAddress.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30961">The proxy server port.</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30962">The proxy protocol to support, in lower case (e.g. socks, http).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="dest_hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30963">The destination hostname the proxy should tunnel to.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="dest_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30964">The destination port to tunnel to.</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="username" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30965">The username to authenticate to the proxy server
|
|
(or %NULL).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="password" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30967">The password to authenticate to the proxy server
|
|
(or %NULL).</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_destination_hostname" c:identifier="g_proxy_address_get_destination_hostname" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30876">Gets @proxy's destination hostname; that is, the name of the host
|
|
that will be connected to via the proxy, not the name of the proxy
|
|
itself.</doc>
|
|
<source-position filename="gproxyaddress.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30884">the @proxy's destination hostname</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30878">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_destination_port" c:identifier="g_proxy_address_get_destination_port" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30889">Gets @proxy's destination port; that is, the port on the
|
|
destination host that will be connected to via the proxy, not the
|
|
port number of the proxy itself.</doc>
|
|
<source-position filename="gproxyaddress.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30897">the @proxy's destination port</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30891">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_destination_protocol" c:identifier="g_proxy_address_get_destination_protocol" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30902">Gets the protocol that is being spoken to the destination
|
|
server; eg, "http" or "ftp".</doc>
|
|
<source-position filename="gproxyaddress.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30909">the @proxy's destination protocol</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30904">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_password" c:identifier="g_proxy_address_get_password" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30914">Gets @proxy's password.</doc>
|
|
<source-position filename="gproxyaddress.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30920">the @proxy's password</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30916">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_protocol" c:identifier="g_proxy_address_get_protocol" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30925">Gets @proxy's protocol. eg, "socks" or "http"</doc>
|
|
<source-position filename="gproxyaddress.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30931">the @proxy's protocol</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30927">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uri" c:identifier="g_proxy_address_get_uri" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30936">Gets the proxy URI that @proxy was constructed from.</doc>
|
|
<source-position filename="gproxyaddress.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30942">the @proxy's URI, or %NULL if unknown</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30938">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_username" c:identifier="g_proxy_address_get_username" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30947">Gets @proxy's username.</doc>
|
|
<source-position filename="gproxyaddress.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30953">the @proxy's username</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30949">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="destination-hostname" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="destination-port" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="destination-protocol" version="2.34" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2725">The protocol being spoke to the destination host, or %NULL if
|
|
the #GProxyAddress doesn't know.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="password" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="protocol" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="uri" version="2.34" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2735">The URI string that the proxy was constructed from (or %NULL
|
|
if the creator didn't specify this).</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="username" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="InetSocketAddress" c:type="GInetSocketAddress"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="ProxyAddressPrivate" c:type="GProxyAddressPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="ProxyAddressClass" c:type="GProxyAddressClass" glib:is-gtype-struct-for="ProxyAddress" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2745">Class structure for #GProxyAddress.</doc>
|
|
<source-position filename="gproxyaddress.h" line="53"/>
|
|
<field name="parent_class">
|
|
<type name="InetSocketAddressClass" c:type="GInetSocketAddressClass"/>
|
|
</field>
|
|
</record>
|
|
<class name="ProxyAddressEnumerator" c:symbol-prefix="proxy_address_enumerator" c:type="GProxyAddressEnumerator" parent="SocketAddressEnumerator" glib:type-name="GProxyAddressEnumerator" glib:get-type="g_proxy_address_enumerator_get_type" glib:type-struct="ProxyAddressEnumeratorClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7384">#GProxyAddressEnumerator is a wrapper around #GSocketAddressEnumerator which
|
|
takes the #GSocketAddress instances returned by the #GSocketAddressEnumerator
|
|
and wraps them in #GProxyAddress instances, using the given
|
|
#GProxyAddressEnumerator:proxy-resolver.
|
|
|
|
This enumerator will be returned (for example, by
|
|
g_socket_connectable_enumerate()) as appropriate when a proxy is configured;
|
|
there should be no need to manually wrap a #GSocketAddressEnumerator instance
|
|
with one.</doc>
|
|
<source-position filename="gproxyaddressenumerator.h" line="74"/>
|
|
<property name="connectable" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="SocketConnectable"/>
|
|
</property>
|
|
<property name="default-port" version="2.38" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2754">The default port to use if #GProxyAddressEnumerator:uri does not
|
|
specify one.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="proxy-resolver" version="2.36" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2764">The proxy resolver to use.</doc>
|
|
<type name="ProxyResolver"/>
|
|
</property>
|
|
<property name="uri" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="ProxyAddressEnumeratorPrivate" c:type="GProxyAddressEnumeratorPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="ProxyAddressEnumeratorClass" c:type="GProxyAddressEnumeratorClass" glib:is-gtype-struct-for="ProxyAddressEnumerator">
|
|
<doc xml:space="preserve" filename="gproxyaddressenumerator.h" line="57">Class structure for #GProxyAddressEnumerator.</doc>
|
|
<source-position filename="gproxyaddressenumerator.h" line="74"/>
|
|
<field name="parent_class" readable="0" private="1">
|
|
<type name="SocketAddressEnumeratorClass" c:type="GSocketAddressEnumeratorClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gproxyaddressenumerator.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gproxyaddressenumerator.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gproxyaddressenumerator.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gproxyaddressenumerator.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gproxyaddressenumerator.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gproxyaddressenumerator.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved7" introspectable="0">
|
|
<callback name="_g_reserved7">
|
|
<source-position filename="gproxyaddressenumerator.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="ProxyAddressEnumeratorPrivate" c:type="GProxyAddressEnumeratorPrivate" disguised="1">
|
|
<source-position filename="gproxyaddressenumerator.h" line="48"/>
|
|
</record>
|
|
<record name="ProxyAddressPrivate" c:type="GProxyAddressPrivate" disguised="1">
|
|
<source-position filename="gproxyaddress.h" line="40"/>
|
|
</record>
|
|
<record name="ProxyInterface" c:type="GProxyInterface" glib:is-gtype-struct-for="Proxy" version="2.26">
|
|
<doc xml:space="preserve" filename="gproxy.h" line="58">Provides an interface for handling proxy connection and payload.</doc>
|
|
<source-position filename="gproxy.h" line="95"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gproxy.h" line="60">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="connect">
|
|
<callback name="connect" throws="1">
|
|
<source-position filename="gproxy.h" line="77"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30995">a #GIOStream that will replace @connection. This might
|
|
be the same as @connection, in which case a reference
|
|
will be added.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30984">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30985">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="proxy_address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30986">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30987">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="connect_async">
|
|
<callback name="connect_async">
|
|
<source-position filename="gproxy.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31004">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31005">a #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="proxy_address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31006">a #GProxyAddress</doc>
|
|
<type name="ProxyAddress" c:type="GProxyAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31007">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31008">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31009">callback data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="connect_finish">
|
|
<callback name="connect_finish" throws="1">
|
|
<source-position filename="gproxy.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31025">a #GIOStream.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31019">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31020">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="supports_hostname">
|
|
<callback name="supports_hostname">
|
|
<source-position filename="gproxy.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31140">%TRUE if hostname resolution is supported.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31130">a #GProxy</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<interface name="ProxyResolver" c:symbol-prefix="proxy_resolver" c:type="GProxyResolver" version="2.26" glib:type-name="GProxyResolver" glib:get-type="g_proxy_resolver_get_type" glib:type-struct="ProxyResolverInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7401">#GProxyResolver provides synchronous and asynchronous network proxy
|
|
resolution. #GProxyResolver is used within #GSocketClient through
|
|
the method g_socket_connectable_proxy_enumerate().
|
|
|
|
Implementations of #GProxyResolver based on libproxy and GNOME settings can
|
|
be found in glib-networking. GIO comes with an implementation for use inside
|
|
Flatpak portals.</doc>
|
|
<source-position filename="gproxyresolver.h" line="67"/>
|
|
<function name="get_default" c:identifier="g_proxy_resolver_get_default" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31043">Gets the default #GProxyResolver for the system.</doc>
|
|
<source-position filename="gproxyresolver.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31048">the default #GProxyResolver.</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="is_supported" invoker="is_supported" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31053">Checks if @resolver can be used on this system. (This is used
|
|
internally; g_proxy_resolver_get_default() will only return a proxy
|
|
resolver that returns %TRUE for this method.)</doc>
|
|
<source-position filename="gproxyresolver.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31061">%TRUE if @resolver is supported.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31055">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup" invoker="lookup" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31066">Looks into the system proxy configuration to determine what proxy,
|
|
if any, to use to connect to @uri. The returned proxy URIs are of
|
|
the form `<protocol>://[user[:password]@]host:port` or
|
|
`direct://`, where <protocol> could be http, rtsp, socks
|
|
or other proxying protocol.
|
|
|
|
If you don't know what network protocol is being used on the
|
|
socket, you should use `none` as the URI protocol.
|
|
In this case, the resolver might still return a generic proxy type
|
|
(such as SOCKS), but would not return protocol-specific proxy types
|
|
(such as http).
|
|
|
|
`direct://` is used when no proxy is needed.
|
|
Direct connection should not be attempted unless it is part of the
|
|
returned array of proxies.</doc>
|
|
<source-position filename="gproxyresolver.h" line="53"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31089">A
|
|
NULL-terminated array of proxy URIs. Must be freed
|
|
with g_strfreev().</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31068">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31069">a URI representing the destination to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31070">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_async" invoker="lookup_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31096">Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more
|
|
details.</doc>
|
|
<source-position filename="gproxyresolver.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31098">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31099">a URI representing the destination to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31100">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31101">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31102">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_finish" invoker="lookup_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31111">Call this function to obtain the array of proxy URIs when
|
|
g_proxy_resolver_lookup_async() is complete. See
|
|
g_proxy_resolver_lookup() for more details.</doc>
|
|
<source-position filename="gproxyresolver.h" line="64"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31121">A
|
|
NULL-terminated array of proxy URIs. Must be freed
|
|
with g_strfreev().</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31113">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31114">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="is_supported" c:identifier="g_proxy_resolver_is_supported" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31053">Checks if @resolver can be used on this system. (This is used
|
|
internally; g_proxy_resolver_get_default() will only return a proxy
|
|
resolver that returns %TRUE for this method.)</doc>
|
|
<source-position filename="gproxyresolver.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31061">%TRUE if @resolver is supported.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31055">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup" c:identifier="g_proxy_resolver_lookup" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31066">Looks into the system proxy configuration to determine what proxy,
|
|
if any, to use to connect to @uri. The returned proxy URIs are of
|
|
the form `<protocol>://[user[:password]@]host:port` or
|
|
`direct://`, where <protocol> could be http, rtsp, socks
|
|
or other proxying protocol.
|
|
|
|
If you don't know what network protocol is being used on the
|
|
socket, you should use `none` as the URI protocol.
|
|
In this case, the resolver might still return a generic proxy type
|
|
(such as SOCKS), but would not return protocol-specific proxy types
|
|
(such as http).
|
|
|
|
`direct://` is used when no proxy is needed.
|
|
Direct connection should not be attempted unless it is part of the
|
|
returned array of proxies.</doc>
|
|
<source-position filename="gproxyresolver.h" line="77"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31089">A
|
|
NULL-terminated array of proxy URIs. Must be freed
|
|
with g_strfreev().</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31068">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31069">a URI representing the destination to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31070">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_async" c:identifier="g_proxy_resolver_lookup_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31096">Asynchronous lookup of proxy. See g_proxy_resolver_lookup() for more
|
|
details.</doc>
|
|
<source-position filename="gproxyresolver.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31098">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31099">a URI representing the destination to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31100">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31101">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31102">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_finish" c:identifier="g_proxy_resolver_lookup_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31111">Call this function to obtain the array of proxy URIs when
|
|
g_proxy_resolver_lookup_async() is complete. See
|
|
g_proxy_resolver_lookup() for more details.</doc>
|
|
<source-position filename="gproxyresolver.h" line="88"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31121">A
|
|
NULL-terminated array of proxy URIs. Must be freed
|
|
with g_strfreev().</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31113">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31114">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="ProxyResolverInterface" c:type="GProxyResolverInterface" glib:is-gtype-struct-for="ProxyResolver">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2773">The virtual function table for #GProxyResolver.</doc>
|
|
<source-position filename="gproxyresolver.h" line="67"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2775">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="is_supported">
|
|
<callback name="is_supported">
|
|
<source-position filename="gproxyresolver.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31061">%TRUE if @resolver is supported.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31055">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup">
|
|
<callback name="lookup" throws="1">
|
|
<source-position filename="gproxyresolver.h" line="53"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31089">A
|
|
NULL-terminated array of proxy URIs. Must be freed
|
|
with g_strfreev().</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31068">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31069">a URI representing the destination to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31070">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_async">
|
|
<callback name="lookup_async">
|
|
<source-position filename="gproxyresolver.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31098">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31099">a URI representing the destination to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31100">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31101">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31102">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_finish">
|
|
<callback name="lookup_finish" throws="1">
|
|
<source-position filename="gproxyresolver.h" line="64"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31121">A
|
|
NULL-terminated array of proxy URIs. Must be freed
|
|
with g_strfreev().</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31113">a #GProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31114">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<function-macro name="REMOTE_ACTION_GROUP" c:identifier="G_REMOTE_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gremoteactiongroup.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="REMOTE_ACTION_GROUP_GET_IFACE" c:identifier="G_REMOTE_ACTION_GROUP_GET_IFACE" introspectable="0">
|
|
<source-position filename="gremoteactiongroup.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="RESOLVER" c:identifier="G_RESOLVER" introspectable="0">
|
|
<source-position filename="gresolver.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="RESOLVER_CLASS" c:identifier="G_RESOLVER_CLASS" introspectable="0">
|
|
<source-position filename="gresolver.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="RESOLVER_GET_CLASS" c:identifier="G_RESOLVER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gresolver.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<callback name="ReallocFunc" c:type="GReallocFunc">
|
|
<doc xml:space="preserve" filename="gmemoryoutputstream.h" line="68">Changes the size of the memory block pointed to by @data to
|
|
@size bytes.
|
|
|
|
The function should have the same semantics as realloc().</doc>
|
|
<source-position filename="gmemoryoutputstream.h" line="80"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gmemoryoutputstream.h" line="78">a pointer to the reallocated memory</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gmemoryoutputstream.h" line="70">memory block to reallocate</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gmemoryoutputstream.h" line="71">size to reallocate @data to</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<interface name="RemoteActionGroup" c:symbol-prefix="remote_action_group" c:type="GRemoteActionGroup" version="2.32" glib:type-name="GRemoteActionGroup" glib:get-type="g_remote_action_group_get_type" glib:type-struct="RemoteActionGroupInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7416">The GRemoteActionGroup interface is implemented by #GActionGroup
|
|
instances that either transmit action invocations to other processes
|
|
or receive action invocations in the local process from other
|
|
processes.
|
|
|
|
The interface has `_full` variants of the two
|
|
methods on #GActionGroup used to activate actions:
|
|
g_action_group_activate_action() and
|
|
g_action_group_change_action_state(). These variants allow a
|
|
"platform data" #GVariant to be specified: a dictionary providing
|
|
context for the action invocation (for example: timestamps, startup
|
|
notification IDs, etc).
|
|
|
|
#GDBusActionGroup implements #GRemoteActionGroup. This provides a
|
|
mechanism to send platform data for action invocations over D-Bus.
|
|
|
|
Additionally, g_dbus_connection_export_action_group() will check if
|
|
the exported #GActionGroup implements #GRemoteActionGroup and use the
|
|
`_full` variants of the calls if available. This
|
|
provides a mechanism by which to receive platform data for action
|
|
invocations that arrive by way of D-Bus.</doc>
|
|
<source-position filename="gremoteactiongroup.h" line="56"/>
|
|
<prerequisite name="ActionGroup"/>
|
|
<virtual-method name="activate_action_full" invoker="activate_action_full" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31145">Activates the remote action.
|
|
|
|
This is the same as g_action_group_activate_action() except that it
|
|
allows for provision of "platform data" to be sent along with the
|
|
activation request. This typically contains details such as the user
|
|
interaction timestamp or startup notification information.
|
|
|
|
@platform_data must be non-%NULL and must have the type
|
|
%G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed.</doc>
|
|
<source-position filename="gremoteactiongroup.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="remote" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31147">a #GDBusActionGroup</doc>
|
|
<type name="RemoteActionGroup" c:type="GRemoteActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31148">the name of the action to activate</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31149">the optional parameter to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31150">the platform data to send</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="change_action_state_full" invoker="change_action_state_full" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31166">Changes the state of a remote action.
|
|
|
|
This is the same as g_action_group_change_action_state() except that
|
|
it allows for provision of "platform data" to be sent along with the
|
|
state change request. This typically contains details such as the
|
|
user interaction timestamp or startup notification information.
|
|
|
|
@platform_data must be non-%NULL and must have the type
|
|
%G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed.</doc>
|
|
<source-position filename="gremoteactiongroup.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="remote" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31168">a #GRemoteActionGroup</doc>
|
|
<type name="RemoteActionGroup" c:type="GRemoteActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31169">the name of the action to change the state of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31170">the new requested value for the state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31171">the platform data to send</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="activate_action_full" c:identifier="g_remote_action_group_activate_action_full" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31145">Activates the remote action.
|
|
|
|
This is the same as g_action_group_activate_action() except that it
|
|
allows for provision of "platform data" to be sent along with the
|
|
activation request. This typically contains details such as the user
|
|
interaction timestamp or startup notification information.
|
|
|
|
@platform_data must be non-%NULL and must have the type
|
|
%G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed.</doc>
|
|
<source-position filename="gremoteactiongroup.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="remote" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31147">a #GDBusActionGroup</doc>
|
|
<type name="RemoteActionGroup" c:type="GRemoteActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31148">the name of the action to activate</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31149">the optional parameter to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31150">the platform data to send</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="change_action_state_full" c:identifier="g_remote_action_group_change_action_state_full" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31166">Changes the state of a remote action.
|
|
|
|
This is the same as g_action_group_change_action_state() except that
|
|
it allows for provision of "platform data" to be sent along with the
|
|
state change request. This typically contains details such as the
|
|
user interaction timestamp or startup notification information.
|
|
|
|
@platform_data must be non-%NULL and must have the type
|
|
%G_VARIANT_TYPE_VARDICT. If it is floating, it will be consumed.</doc>
|
|
<source-position filename="gremoteactiongroup.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="remote" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31168">a #GRemoteActionGroup</doc>
|
|
<type name="RemoteActionGroup" c:type="GRemoteActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31169">the name of the action to change the state of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31170">the new requested value for the state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31171">the platform data to send</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="RemoteActionGroupInterface" c:type="GRemoteActionGroupInterface" glib:is-gtype-struct-for="RemoteActionGroup" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2795">The virtual function table for #GRemoteActionGroup.</doc>
|
|
<source-position filename="gremoteactiongroup.h" line="56"/>
|
|
<field name="g_iface">
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="activate_action_full">
|
|
<callback name="activate_action_full">
|
|
<source-position filename="gremoteactiongroup.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="remote" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31147">a #GDBusActionGroup</doc>
|
|
<type name="RemoteActionGroup" c:type="GRemoteActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31148">the name of the action to activate</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31149">the optional parameter to the activation</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31150">the platform data to send</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="change_action_state_full">
|
|
<callback name="change_action_state_full">
|
|
<source-position filename="gremoteactiongroup.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="remote" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31168">a #GRemoteActionGroup</doc>
|
|
<type name="RemoteActionGroup" c:type="GRemoteActionGroup*"/>
|
|
</parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31169">the name of the action to change the state of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31170">the new requested value for the state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="platform_data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31171">the platform data to send</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="Resolver" c:symbol-prefix="resolver" c:type="GResolver" parent="GObject.Object" abstract="1" glib:type-name="GResolver" glib:get-type="g_resolver_get_type" glib:type-struct="ResolverClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7448">#GResolver provides cancellable synchronous and asynchronous DNS
|
|
resolution, for hostnames (g_resolver_lookup_by_address(),
|
|
g_resolver_lookup_by_name() and their async variants) and SRV
|
|
(service) records (g_resolver_lookup_service()).
|
|
|
|
#GNetworkAddress and #GNetworkService provide wrappers around
|
|
#GResolver functionality that also implement #GSocketConnectable,
|
|
making it easy to connect to a remote host/service.</doc>
|
|
<source-position filename="gresolver.h" line="182"/>
|
|
<function name="free_addresses" c:identifier="g_resolver_free_addresses" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31197">Frees @addresses (which should be the return value from
|
|
g_resolver_lookup_by_name() or g_resolver_lookup_by_name_finish()).
|
|
(This is a convenience method; you can also simply free the results
|
|
by hand.)</doc>
|
|
<source-position filename="gresolver.h" line="223"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="addresses" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31199">a #GList of #GInetAddress</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="free_targets" c:identifier="g_resolver_free_targets" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31210">Frees @targets (which should be the return value from
|
|
g_resolver_lookup_service() or g_resolver_lookup_service_finish()).
|
|
(This is a convenience method; you can also simply free the
|
|
results by hand.)</doc>
|
|
<source-position filename="gresolver.h" line="276"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="targets" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31212">a #GList of #GSrvTarget</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_default" c:identifier="g_resolver_get_default" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31223">Gets the default #GResolver. You should unref it when you are done
|
|
with it. #GResolver may use its reference count as a hint about how
|
|
many threads it should allocate for concurrent DNS resolutions.</doc>
|
|
<source-position filename="gresolver.h" line="187"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31230">the default #GResolver.</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="lookup_by_address" invoker="lookup_by_address" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31235">Synchronously reverse-resolves @address to determine its
|
|
associated hostname.
|
|
|
|
If the DNS resolution fails, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError.
|
|
|
|
If @cancellable is non-%NULL, it can be used to cancel the
|
|
operation, in which case @error (if non-%NULL) will be set to
|
|
%G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31252">a hostname (either ASCII-only, or in ASCII-encoded
|
|
form), or %NULL on error.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31237">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31238">the address to reverse-resolve</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31239">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_address_async" invoker="lookup_by_address_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31258">Begins asynchronously reverse-resolving @address to determine its
|
|
associated hostname, and eventually calls @callback, which must
|
|
call g_resolver_lookup_by_address_finish() to get the final result.</doc>
|
|
<source-position filename="gresolver.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31260">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31261">the address to reverse-resolve</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31262">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31263">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31264">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_address_finish" invoker="lookup_by_address_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31274">Retrieves the result of a previous call to
|
|
g_resolver_lookup_by_address_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="92"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31287">a hostname (either ASCII-only, or in ASCII-encoded
|
|
form), or %NULL on error.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31276">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31277">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_name" invoker="lookup_by_name" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31293">Synchronously resolves @hostname to determine its associated IP
|
|
address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
|
|
the textual form of an IP address (in which case this just becomes
|
|
a wrapper around g_inet_address_new_from_string()).
|
|
|
|
On success, g_resolver_lookup_by_name() will return a non-empty #GList of
|
|
#GInetAddress, sorted in order of preference and guaranteed to not
|
|
contain duplicates. That is, if using the result to connect to
|
|
@hostname, you should attempt to connect to the first address
|
|
first, then the second if the first fails, etc. If you are using
|
|
the result to listen on a socket, it is appropriate to add each
|
|
result using e.g. g_socket_listener_add_address().
|
|
|
|
If the DNS resolution fails, @error (if non-%NULL) will be set to a
|
|
value from #GResolverError and %NULL will be returned.
|
|
|
|
If @cancellable is non-%NULL, it can be used to cancel the
|
|
operation, in which case @error (if non-%NULL) will be set to
|
|
%G_IO_ERROR_CANCELLED.
|
|
|
|
If you are planning to connect to a socket on the resolved IP
|
|
address, it may be easier to create a #GNetworkAddress and use its
|
|
#GSocketConnectable interface.</doc>
|
|
<source-position filename="gresolver.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31324">a non-empty #GList
|
|
of #GInetAddress, or %NULL on error. You
|
|
must unref each of the addresses and free the list when you are
|
|
done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31295">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31296">the hostname to look up</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31297">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_name_async" invoker="lookup_by_name_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31332">Begins asynchronously resolving @hostname to determine its
|
|
associated IP address(es), and eventually calls @callback, which
|
|
must call g_resolver_lookup_by_name_finish() to get the result.
|
|
See g_resolver_lookup_by_name() for more details.</doc>
|
|
<source-position filename="gresolver.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31334">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31335">the hostname to look up the address of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31336">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31337">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31338">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_name_finish" invoker="lookup_by_name_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31349">Retrieves the result of a call to
|
|
g_resolver_lookup_by_name_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="79"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31362">a #GList
|
|
of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
|
|
for more details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31351">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31352">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_name_with_flags" invoker="lookup_by_name_with_flags" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31369">This differs from g_resolver_lookup_by_name() in that you can modify
|
|
the lookup behavior with @flags. For example this can be used to limit
|
|
results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY.</doc>
|
|
<source-position filename="gresolver.h" line="176"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31381">a non-empty #GList
|
|
of #GInetAddress, or %NULL on error. You
|
|
must unref each of the addresses and free the list when you are
|
|
done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31371">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31372">the hostname to look up</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31373">extra #GResolverNameLookupFlags for the lookup</doc>
|
|
<type name="ResolverNameLookupFlags" c:type="GResolverNameLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31374">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_name_with_flags_async" invoker="lookup_by_name_with_flags_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31389">Begins asynchronously resolving @hostname to determine its
|
|
associated IP address(es), and eventually calls @callback, which
|
|
must call g_resolver_lookup_by_name_with_flags_finish() to get the result.
|
|
See g_resolver_lookup_by_name() for more details.</doc>
|
|
<source-position filename="gresolver.h" line="141"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31391">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31392">the hostname to look up the address of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31393">extra #GResolverNameLookupFlags for the lookup</doc>
|
|
<type name="ResolverNameLookupFlags" c:type="GResolverNameLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31394">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31395">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31396">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_by_name_with_flags_finish" invoker="lookup_by_name_with_flags_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31407">Retrieves the result of a call to
|
|
g_resolver_lookup_by_name_with_flags_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="158"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31420">a #GList
|
|
of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
|
|
for more details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31409">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31410">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_records" invoker="lookup_records" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31427">Synchronously performs a DNS record lookup for the given @rrname and returns
|
|
a list of records as #GVariant tuples. See #GResolverRecordType for
|
|
information on what the records contain for each @record_type.
|
|
|
|
If the DNS resolution fails, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError and %NULL will be returned.
|
|
|
|
If @cancellable is non-%NULL, it can be used to cancel the
|
|
operation, in which case @error (if non-%NULL) will be set to
|
|
%G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="109"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31446">a non-empty #GList of
|
|
#GVariant, or %NULL on error. You must free each of the records and the list
|
|
when you are done with it. (You can use g_list_free_full() with
|
|
g_variant_unref() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31429">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31430">the DNS name to look up the record for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="record_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31431">the type of DNS record to look up</doc>
|
|
<type name="ResolverRecordType" c:type="GResolverRecordType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31432">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_records_async" invoker="lookup_records_async" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31454">Begins asynchronously performing a DNS lookup for the given
|
|
@rrname, and eventually calls @callback, which must call
|
|
g_resolver_lookup_records_finish() to get the final result. See
|
|
g_resolver_lookup_records() for more details.</doc>
|
|
<source-position filename="gresolver.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31456">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31457">the DNS name to look up the record for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="record_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31458">the type of DNS record to look up</doc>
|
|
<type name="ResolverRecordType" c:type="GResolverRecordType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31459">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31460">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31461">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_records_finish" invoker="lookup_records_finish" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31472">Retrieves the result of a previous call to
|
|
g_resolver_lookup_records_async(). Returns a non-empty list of records as
|
|
#GVariant tuples. See #GResolverRecordType for information on what the
|
|
records contain.
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="122"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31487">a non-empty #GList of
|
|
#GVariant, or %NULL on error. You must free each of the records and the list
|
|
when you are done with it. (You can use g_list_free_full() with
|
|
g_variant_unref() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31474">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31475">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_service" introspectable="0" throws="1">
|
|
<source-position filename="gresolver.h" line="96"/>
|
|
<return-value>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_service_async">
|
|
<source-position filename="gresolver.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_service_finish" invoker="lookup_service_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31554">Retrieves the result of a previous call to
|
|
g_resolver_lookup_service_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="105"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31567">a non-empty #GList of
|
|
#GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more
|
|
details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="SrvTarget"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31556">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31557">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="reload">
|
|
<source-position filename="gresolver.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="lookup_by_address" c:identifier="g_resolver_lookup_by_address" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31235">Synchronously reverse-resolves @address to determine its
|
|
associated hostname.
|
|
|
|
If the DNS resolution fails, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError.
|
|
|
|
If @cancellable is non-%NULL, it can be used to cancel the
|
|
operation, in which case @error (if non-%NULL) will be set to
|
|
%G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="225"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31252">a hostname (either ASCII-only, or in ASCII-encoded
|
|
form), or %NULL on error.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31237">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31238">the address to reverse-resolve</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31239">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_address_async" c:identifier="g_resolver_lookup_by_address_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31258">Begins asynchronously reverse-resolving @address to determine its
|
|
associated hostname, and eventually calls @callback, which must
|
|
call g_resolver_lookup_by_address_finish() to get the final result.</doc>
|
|
<source-position filename="gresolver.h" line="230"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31260">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31261">the address to reverse-resolve</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31262">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31263">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31264">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_address_finish" c:identifier="g_resolver_lookup_by_address_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31274">Retrieves the result of a previous call to
|
|
g_resolver_lookup_by_address_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="236"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31287">a hostname (either ASCII-only, or in ASCII-encoded
|
|
form), or %NULL on error.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31276">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31277">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_name" c:identifier="g_resolver_lookup_by_name" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31293">Synchronously resolves @hostname to determine its associated IP
|
|
address(es). @hostname may be an ASCII-only or UTF-8 hostname, or
|
|
the textual form of an IP address (in which case this just becomes
|
|
a wrapper around g_inet_address_new_from_string()).
|
|
|
|
On success, g_resolver_lookup_by_name() will return a non-empty #GList of
|
|
#GInetAddress, sorted in order of preference and guaranteed to not
|
|
contain duplicates. That is, if using the result to connect to
|
|
@hostname, you should attempt to connect to the first address
|
|
first, then the second if the first fails, etc. If you are using
|
|
the result to listen on a socket, it is appropriate to add each
|
|
result using e.g. g_socket_listener_add_address().
|
|
|
|
If the DNS resolution fails, @error (if non-%NULL) will be set to a
|
|
value from #GResolverError and %NULL will be returned.
|
|
|
|
If @cancellable is non-%NULL, it can be used to cancel the
|
|
operation, in which case @error (if non-%NULL) will be set to
|
|
%G_IO_ERROR_CANCELLED.
|
|
|
|
If you are planning to connect to a socket on the resolved IP
|
|
address, it may be easier to create a #GNetworkAddress and use its
|
|
#GSocketConnectable interface.</doc>
|
|
<source-position filename="gresolver.h" line="191"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31324">a non-empty #GList
|
|
of #GInetAddress, or %NULL on error. You
|
|
must unref each of the addresses and free the list when you are
|
|
done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31295">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31296">the hostname to look up</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31297">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_name_async" c:identifier="g_resolver_lookup_by_name_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31332">Begins asynchronously resolving @hostname to determine its
|
|
associated IP address(es), and eventually calls @callback, which
|
|
must call g_resolver_lookup_by_name_finish() to get the result.
|
|
See g_resolver_lookup_by_name() for more details.</doc>
|
|
<source-position filename="gresolver.h" line="196"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31334">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31335">the hostname to look up the address of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31336">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31337">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31338">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_name_finish" c:identifier="g_resolver_lookup_by_name_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31349">Retrieves the result of a call to
|
|
g_resolver_lookup_by_name_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="202"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31362">a #GList
|
|
of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
|
|
for more details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31351">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31352">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_name_with_flags" c:identifier="g_resolver_lookup_by_name_with_flags" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31369">This differs from g_resolver_lookup_by_name() in that you can modify
|
|
the lookup behavior with @flags. For example this can be used to limit
|
|
results with #G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY.</doc>
|
|
<source-position filename="gresolver.h" line="217"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31381">a non-empty #GList
|
|
of #GInetAddress, or %NULL on error. You
|
|
must unref each of the addresses and free the list when you are
|
|
done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31371">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31372">the hostname to look up</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31373">extra #GResolverNameLookupFlags for the lookup</doc>
|
|
<type name="ResolverNameLookupFlags" c:type="GResolverNameLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31374">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_name_with_flags_async" c:identifier="g_resolver_lookup_by_name_with_flags_async" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31389">Begins asynchronously resolving @hostname to determine its
|
|
associated IP address(es), and eventually calls @callback, which
|
|
must call g_resolver_lookup_by_name_with_flags_finish() to get the result.
|
|
See g_resolver_lookup_by_name() for more details.</doc>
|
|
<source-position filename="gresolver.h" line="206"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31391">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31392">the hostname to look up the address of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31393">extra #GResolverNameLookupFlags for the lookup</doc>
|
|
<type name="ResolverNameLookupFlags" c:type="GResolverNameLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31394">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31395">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31396">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_by_name_with_flags_finish" c:identifier="g_resolver_lookup_by_name_with_flags_finish" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31407">Retrieves the result of a call to
|
|
g_resolver_lookup_by_name_with_flags_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="213"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31420">a #GList
|
|
of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
|
|
for more details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31409">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31410">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_records" c:identifier="g_resolver_lookup_records" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31427">Synchronously performs a DNS record lookup for the given @rrname and returns
|
|
a list of records as #GVariant tuples. See #GResolverRecordType for
|
|
information on what the records contain for each @record_type.
|
|
|
|
If the DNS resolution fails, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError and %NULL will be returned.
|
|
|
|
If @cancellable is non-%NULL, it can be used to cancel the
|
|
operation, in which case @error (if non-%NULL) will be set to
|
|
%G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="259"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31446">a non-empty #GList of
|
|
#GVariant, or %NULL on error. You must free each of the records and the list
|
|
when you are done with it. (You can use g_list_free_full() with
|
|
g_variant_unref() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31429">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31430">the DNS name to look up the record for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="record_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31431">the type of DNS record to look up</doc>
|
|
<type name="ResolverRecordType" c:type="GResolverRecordType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31432">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_records_async" c:identifier="g_resolver_lookup_records_async" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31454">Begins asynchronously performing a DNS lookup for the given
|
|
@rrname, and eventually calls @callback, which must call
|
|
g_resolver_lookup_records_finish() to get the final result. See
|
|
g_resolver_lookup_records() for more details.</doc>
|
|
<source-position filename="gresolver.h" line="265"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31456">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31457">the DNS name to look up the record for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="record_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31458">the type of DNS record to look up</doc>
|
|
<type name="ResolverRecordType" c:type="GResolverRecordType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31459">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31460">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31461">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_records_finish" c:identifier="g_resolver_lookup_records_finish" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31472">Retrieves the result of a previous call to
|
|
g_resolver_lookup_records_async(). Returns a non-empty list of records as
|
|
#GVariant tuples. See #GResolverRecordType for information on what the
|
|
records contain.
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="272"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31487">a non-empty #GList of
|
|
#GVariant, or %NULL on error. You must free each of the records and the list
|
|
when you are done with it. (You can use g_list_free_full() with
|
|
g_variant_unref() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31474">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31475">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_service" c:identifier="g_resolver_lookup_service" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31495">Synchronously performs a DNS SRV lookup for the given @service and
|
|
@protocol in the given @domain and returns an array of #GSrvTarget.
|
|
@domain may be an ASCII-only or UTF-8 hostname. Note also that the
|
|
@service and @protocol arguments do not include the leading underscore
|
|
that appears in the actual DNS entry.
|
|
|
|
On success, g_resolver_lookup_service() will return a non-empty #GList of
|
|
#GSrvTarget, sorted in order of preference. (That is, you should
|
|
attempt to connect to the first target first, then the second if
|
|
the first fails, etc.)
|
|
|
|
If the DNS resolution fails, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError and %NULL will be returned.
|
|
|
|
If @cancellable is non-%NULL, it can be used to cancel the
|
|
operation, in which case @error (if non-%NULL) will be set to
|
|
%G_IO_ERROR_CANCELLED.
|
|
|
|
If you are planning to connect to the service, it is usually easier
|
|
to create a #GNetworkService and use its #GSocketConnectable
|
|
interface.</doc>
|
|
<source-position filename="gresolver.h" line="240"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31526">a non-empty #GList of
|
|
#GSrvTarget, or %NULL on error. You must free each of the targets and the
|
|
list when you are done with it. (You can use g_resolver_free_targets() to do
|
|
this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="SrvTarget"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31497">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31498">the service type to look up (eg, "ldap")</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31499">the networking protocol to use for @service (eg, "tcp")</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31500">the DNS domain to look up the service in</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31501">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_service_async" c:identifier="g_resolver_lookup_service_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31534">Begins asynchronously performing a DNS SRV lookup for the given
|
|
@service and @protocol in the given @domain, and eventually calls
|
|
@callback, which must call g_resolver_lookup_service_finish() to
|
|
get the final result. See g_resolver_lookup_service() for more
|
|
details.</doc>
|
|
<source-position filename="gresolver.h" line="247"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31536">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31537">the service type to look up (eg, "ldap")</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31538">the networking protocol to use for @service (eg, "tcp")</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31539">the DNS domain to look up the service in</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31540">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31541">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31542">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_service_finish" c:identifier="g_resolver_lookup_service_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31554">Retrieves the result of a previous call to
|
|
g_resolver_lookup_service_async().
|
|
|
|
If the DNS resolution failed, @error (if non-%NULL) will be set to
|
|
a value from #GResolverError. If the operation was cancelled,
|
|
@error will be set to %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gresolver.h" line="255"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31567">a non-empty #GList of
|
|
#GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more
|
|
details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="SrvTarget"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31556">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31557">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_default" c:identifier="g_resolver_set_default" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31574">Sets @resolver to be the application's default resolver (reffing
|
|
@resolver, and unreffing the previous default resolver, if any).
|
|
Future calls to g_resolver_get_default() will return this resolver.
|
|
|
|
This can be used if an application wants to perform any sort of DNS
|
|
caching or "pinning"; it can implement its own #GResolver that
|
|
calls the original default resolver for DNS operations, and
|
|
implements its own cache policies on top of that, and then set
|
|
itself as the default resolver for all later code to use.</doc>
|
|
<source-position filename="gresolver.h" line="189"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31576">the new default #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="ResolverPrivate" c:type="GResolverPrivate*"/>
|
|
</field>
|
|
<glib:signal name="reload" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2817">Emitted when the resolver notices that the system resolver
|
|
configuration has changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="ResolverClass" c:type="GResolverClass" glib:is-gtype-struct-for="Resolver">
|
|
<source-position filename="gresolver.h" line="182"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="reload">
|
|
<callback name="reload">
|
|
<source-position filename="gresolver.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_name">
|
|
<callback name="lookup_by_name" throws="1">
|
|
<source-position filename="gresolver.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31324">a non-empty #GList
|
|
of #GInetAddress, or %NULL on error. You
|
|
must unref each of the addresses and free the list when you are
|
|
done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31295">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31296">the hostname to look up</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31297">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_name_async">
|
|
<callback name="lookup_by_name_async">
|
|
<source-position filename="gresolver.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31334">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31335">the hostname to look up the address of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31336">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31337">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31338">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_name_finish">
|
|
<callback name="lookup_by_name_finish" throws="1">
|
|
<source-position filename="gresolver.h" line="79"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31362">a #GList
|
|
of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
|
|
for more details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31351">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31352">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_address">
|
|
<callback name="lookup_by_address" throws="1">
|
|
<source-position filename="gresolver.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31252">a hostname (either ASCII-only, or in ASCII-encoded
|
|
form), or %NULL on error.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31237">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31238">the address to reverse-resolve</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31239">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_address_async">
|
|
<callback name="lookup_by_address_async">
|
|
<source-position filename="gresolver.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31260">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31261">the address to reverse-resolve</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31262">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31263">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31264">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_address_finish">
|
|
<callback name="lookup_by_address_finish" throws="1">
|
|
<source-position filename="gresolver.h" line="92"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31287">a hostname (either ASCII-only, or in ASCII-encoded
|
|
form), or %NULL on error.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31276">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31277">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_service" introspectable="0">
|
|
<callback name="lookup_service" introspectable="0" throws="1">
|
|
<source-position filename="gresolver.h" line="96"/>
|
|
<return-value>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_service_async">
|
|
<callback name="lookup_service_async">
|
|
<source-position filename="gresolver.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_service_finish">
|
|
<callback name="lookup_service_finish" throws="1">
|
|
<source-position filename="gresolver.h" line="105"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31567">a non-empty #GList of
|
|
#GSrvTarget, or %NULL on error. See g_resolver_lookup_service() for more
|
|
details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="SrvTarget"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31556">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31557">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_records">
|
|
<callback name="lookup_records" throws="1">
|
|
<source-position filename="gresolver.h" line="109"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31446">a non-empty #GList of
|
|
#GVariant, or %NULL on error. You must free each of the records and the list
|
|
when you are done with it. (You can use g_list_free_full() with
|
|
g_variant_unref() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31429">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31430">the DNS name to look up the record for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="record_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31431">the type of DNS record to look up</doc>
|
|
<type name="ResolverRecordType" c:type="GResolverRecordType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31432">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_records_async">
|
|
<callback name="lookup_records_async">
|
|
<source-position filename="gresolver.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31456">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="rrname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31457">the DNS name to look up the record for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="record_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31458">the type of DNS record to look up</doc>
|
|
<type name="ResolverRecordType" c:type="GResolverRecordType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31459">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31460">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31461">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_records_finish">
|
|
<callback name="lookup_records_finish" throws="1">
|
|
<source-position filename="gresolver.h" line="122"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31487">a non-empty #GList of
|
|
#GVariant, or %NULL on error. You must free each of the records and the list
|
|
when you are done with it. (You can use g_list_free_full() with
|
|
g_variant_unref() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="GLib.Variant"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31474">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31475">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_name_with_flags_async">
|
|
<callback name="lookup_by_name_with_flags_async">
|
|
<source-position filename="gresolver.h" line="141"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31391">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31392">the hostname to look up the address of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31393">extra #GResolverNameLookupFlags for the lookup</doc>
|
|
<type name="ResolverNameLookupFlags" c:type="GResolverNameLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31394">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31395">callback to call after resolution completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31396">data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_name_with_flags_finish">
|
|
<callback name="lookup_by_name_with_flags_finish" throws="1">
|
|
<source-position filename="gresolver.h" line="158"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31420">a #GList
|
|
of #GInetAddress, or %NULL on error. See g_resolver_lookup_by_name()
|
|
for more details.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31409">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31410">the result passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_by_name_with_flags">
|
|
<callback name="lookup_by_name_with_flags" throws="1">
|
|
<source-position filename="gresolver.h" line="176"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31381">a non-empty #GList
|
|
of #GInetAddress, or %NULL on error. You
|
|
must unref each of the addresses and free the list when you are
|
|
done with it. (You can use g_resolver_free_addresses() to do this.)</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="InetAddress"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31371">a #GResolver</doc>
|
|
<type name="Resolver" c:type="GResolver*"/>
|
|
</parameter>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31372">the hostname to look up</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31373">extra #GResolverNameLookupFlags for the lookup</doc>
|
|
<type name="ResolverNameLookupFlags" c:type="GResolverNameLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31374">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<enumeration name="ResolverError" version="2.22" glib:type-name="GResolverError" glib:get-type="g_resolver_error_get_type" c:type="GResolverError" glib:error-domain="g-resolver-error-quark">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="697">An error code used with %G_RESOLVER_ERROR in a #GError returned
|
|
from a #GResolver routine.</doc>
|
|
<member name="not_found" value="0" c:identifier="G_RESOLVER_ERROR_NOT_FOUND" glib:nick="not-found">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="699">the requested name/address/service was not
|
|
found</doc>
|
|
</member>
|
|
<member name="temporary_failure" value="1" c:identifier="G_RESOLVER_ERROR_TEMPORARY_FAILURE" glib:nick="temporary-failure">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="701">the requested information could not
|
|
be looked up due to a network error or similar problem</doc>
|
|
</member>
|
|
<member name="internal" value="2" c:identifier="G_RESOLVER_ERROR_INTERNAL" glib:nick="internal">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="703">unknown error</doc>
|
|
</member>
|
|
<function name="quark" c:identifier="g_resolver_error_quark" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31187">Gets the #GResolver Error Quark.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31192">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
</enumeration>
|
|
<bitfield name="ResolverNameLookupFlags" version="2.60" glib:type-name="GResolverNameLookupFlags" glib:get-type="g_resolver_name_lookup_flags_get_type" c:type="GResolverNameLookupFlags">
|
|
<doc xml:space="preserve" filename="gresolver.h" line="47">Flags to modify lookup behavior.</doc>
|
|
<member name="default" value="0" c:identifier="G_RESOLVER_NAME_LOOKUP_FLAGS_DEFAULT" glib:nick="default">
|
|
<doc xml:space="preserve" filename="gresolver.h" line="49">default behavior (same as g_resolver_lookup_by_name())</doc>
|
|
</member>
|
|
<member name="ipv4_only" value="1" c:identifier="G_RESOLVER_NAME_LOOKUP_FLAGS_IPV4_ONLY" glib:nick="ipv4-only">
|
|
<doc xml:space="preserve" filename="gresolver.h" line="50">only resolve ipv4 addresses</doc>
|
|
</member>
|
|
<member name="ipv6_only" value="2" c:identifier="G_RESOLVER_NAME_LOOKUP_FLAGS_IPV6_ONLY" glib:nick="ipv6-only">
|
|
<doc xml:space="preserve" filename="gresolver.h" line="51">only resolve ipv6 addresses</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="ResolverPrivate" c:type="GResolverPrivate" disguised="1">
|
|
<source-position filename="gresolver.h" line="38"/>
|
|
</record>
|
|
<enumeration name="ResolverRecordType" version="2.34" glib:type-name="GResolverRecordType" glib:get-type="g_resolver_record_type_get_type" c:type="GResolverRecordType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="716">The type of record that g_resolver_lookup_records() or
|
|
g_resolver_lookup_records_async() should retrieve. The records are returned
|
|
as lists of #GVariant tuples. Each record type has different values in
|
|
the variant tuples returned.
|
|
|
|
%G_RESOLVER_RECORD_SRV records are returned as variants with the signature
|
|
`(qqqs)`, containing a `guint16` with the priority, a `guint16` with the
|
|
weight, a `guint16` with the port, and a string of the hostname.
|
|
|
|
%G_RESOLVER_RECORD_MX records are returned as variants with the signature
|
|
`(qs)`, representing a `guint16` with the preference, and a string containing
|
|
the mail exchanger hostname.
|
|
|
|
%G_RESOLVER_RECORD_TXT records are returned as variants with the signature
|
|
`(as)`, representing an array of the strings in the text record. Note: Most TXT
|
|
records only contain a single string, but
|
|
[RFC 1035](https://tools.ietf.org/html/rfc1035#section-3.3.14) does allow a
|
|
record to contain multiple strings. The RFC which defines the interpretation
|
|
of a specific TXT record will likely require concatenation of multiple
|
|
strings if they are present, as with
|
|
[RFC 7208](https://tools.ietf.org/html/rfc7208#section-3.3).
|
|
|
|
%G_RESOLVER_RECORD_SOA records are returned as variants with the signature
|
|
`(ssuuuuu)`, representing a string containing the primary name server, a
|
|
string containing the administrator, the serial as a `guint32`, the refresh
|
|
interval as a `guint32`, the retry interval as a `guint32`, the expire timeout
|
|
as a `guint32`, and the TTL as a `guint32`.
|
|
|
|
%G_RESOLVER_RECORD_NS records are returned as variants with the signature
|
|
`(s)`, representing a string of the hostname of the name server.</doc>
|
|
<member name="srv" value="1" c:identifier="G_RESOLVER_RECORD_SRV" glib:nick="srv">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="718">look up DNS SRV records for a domain</doc>
|
|
</member>
|
|
<member name="mx" value="2" c:identifier="G_RESOLVER_RECORD_MX" glib:nick="mx">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="719">look up DNS MX records for a domain</doc>
|
|
</member>
|
|
<member name="txt" value="3" c:identifier="G_RESOLVER_RECORD_TXT" glib:nick="txt">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="720">look up DNS TXT records for a name</doc>
|
|
</member>
|
|
<member name="soa" value="4" c:identifier="G_RESOLVER_RECORD_SOA" glib:nick="soa">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="721">look up DNS SOA records for a zone</doc>
|
|
</member>
|
|
<member name="ns" value="5" c:identifier="G_RESOLVER_RECORD_NS" glib:nick="ns">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="722">look up DNS NS records for a domain</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="Resource" c:type="GResource" version="2.32" glib:type-name="GResource" glib:get-type="g_resource_get_type" c:symbol-prefix="resource">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7464">Applications and libraries often contain binary or textual data that is
|
|
really part of the application, rather than user data. For instance
|
|
#GtkBuilder .ui files, splashscreen images, GMenu markup XML, CSS files,
|
|
icons, etc. These are often shipped as files in `$datadir/appname`, or
|
|
manually included as literal strings in the code.
|
|
|
|
The #GResource API and the [glib-compile-resources][glib-compile-resources] program
|
|
provide a convenient and efficient alternative to this which has some nice properties. You
|
|
maintain the files as normal files, so its easy to edit them, but during the build the files
|
|
are combined into a binary bundle that is linked into the executable. This means that loading
|
|
the resource files are efficient (as they are already in memory, shared with other instances) and
|
|
simple (no need to check for things like I/O errors or locate the files in the filesystem). It
|
|
also makes it easier to create relocatable applications.
|
|
|
|
Resource files can also be marked as compressed. Such files will be included in the resource bundle
|
|
in a compressed form, but will be automatically uncompressed when the resource is used. This
|
|
is very useful e.g. for larger text files that are parsed once (or rarely) and then thrown away.
|
|
|
|
Resource files can also be marked to be preprocessed, by setting the value of the
|
|
`preprocess` attribute to a comma-separated list of preprocessing options.
|
|
The only options currently supported are:
|
|
|
|
`xml-stripblanks` which will use the xmllint command
|
|
to strip ignorable whitespace from the XML file. For this to work,
|
|
the `XMLLINT` environment variable must be set to the full path to
|
|
the xmllint executable, or xmllint must be in the `PATH`; otherwise
|
|
the preprocessing step is skipped.
|
|
|
|
`to-pixdata` which will use the gdk-pixbuf-pixdata command to convert
|
|
images to the GdkPixdata format, which allows you to create pixbufs directly using the data inside
|
|
the resource file, rather than an (uncompressed) copy of it. For this, the gdk-pixbuf-pixdata
|
|
program must be in the PATH, or the `GDK_PIXBUF_PIXDATA` environment variable must be
|
|
set to the full path to the gdk-pixbuf-pixdata executable; otherwise the resource compiler will
|
|
abort.
|
|
|
|
Resource files will be exported in the GResource namespace using the
|
|
combination of the given `prefix` and the filename from the `file` element.
|
|
The `alias` attribute can be used to alter the filename to expose them at a
|
|
different location in the resource namespace. Typically, this is used to
|
|
include files from a different source directory without exposing the source
|
|
directory in the resource namespace, as in the example below.
|
|
|
|
Resource bundles are created by the [glib-compile-resources][glib-compile-resources] program
|
|
which takes an XML file that describes the bundle, and a set of files that the XML references. These
|
|
are combined into a binary resource bundle.
|
|
|
|
An example resource description:
|
|
|[
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<gresources>
|
|
<gresource prefix="/org/gtk/Example">
|
|
<file>data/splashscreen.png</file>
|
|
<file compressed="true">dialog.ui</file>
|
|
<file preprocess="xml-stripblanks">menumarkup.xml</file>
|
|
<file alias="example.css">data/example.css</file>
|
|
</gresource>
|
|
</gresources>
|
|
]|
|
|
|
|
This will create a resource bundle with the following files:
|
|
|[
|
|
/org/gtk/Example/data/splashscreen.png
|
|
/org/gtk/Example/dialog.ui
|
|
/org/gtk/Example/menumarkup.xml
|
|
/org/gtk/Example/example.css
|
|
]|
|
|
|
|
Note that all resources in the process share the same namespace, so use Java-style
|
|
path prefixes (like in the above example) to avoid conflicts.
|
|
|
|
You can then use [glib-compile-resources][glib-compile-resources] to compile the XML to a
|
|
binary bundle that you can load with g_resource_load(). However, its more common to use the --generate-source and
|
|
--generate-header arguments to create a source file and header to link directly into your application.
|
|
This will generate `get_resource()`, `register_resource()` and
|
|
`unregister_resource()` functions, prefixed by the `--c-name` argument passed
|
|
to [glib-compile-resources][glib-compile-resources]. `get_resource()` returns
|
|
the generated #GResource object. The register and unregister functions
|
|
register the resource so its files can be accessed using
|
|
g_resources_lookup_data().
|
|
|
|
Once a #GResource has been created and registered all the data in it can be accessed globally in the process by
|
|
using API calls like g_resources_open_stream() to stream the data or g_resources_lookup_data() to get a direct pointer
|
|
to the data. You can also use URIs like "resource:///org/gtk/Example/data/splashscreen.png" with #GFile to access
|
|
the resource data.
|
|
|
|
Some higher-level APIs, such as #GtkApplication, will automatically load
|
|
resources from certain well-known paths in the resource namespace as a
|
|
convenience. See the documentation for those APIs for details.
|
|
|
|
There are two forms of the generated source, the default version uses the compiler support for constructor
|
|
and destructor functions (where available) to automatically create and register the #GResource on startup
|
|
or library load time. If you pass `--manual-register`, two functions to register/unregister the resource are created
|
|
instead. This requires an explicit initialization call in your application/library, but it works on all platforms,
|
|
even on the minor ones where constructors are not supported. (Constructor support is available for at least Win32, Mac OS and Linux.)
|
|
|
|
Note that resource data can point directly into the data segment of e.g. a library, so if you are unloading libraries
|
|
during runtime you need to be very careful with keeping around pointers to data from a resource, as this goes away
|
|
when the library is unloaded. However, in practice this is not generally a problem, since most resource accesses
|
|
are for your own resources, and resource data is often used once, during parsing, and then released.
|
|
|
|
When debugging a program or testing a change to an installed version, it is often useful to be able to
|
|
replace resources in the program or library, without recompiling, for debugging or quick hacking and testing
|
|
purposes. Since GLib 2.50, it is possible to use the `G_RESOURCE_OVERLAYS` environment variable to selectively overlay
|
|
resources with replacements from the filesystem. It is a %G_SEARCHPATH_SEPARATOR-separated list of substitutions to perform
|
|
during resource lookups.
|
|
|
|
A substitution has the form
|
|
|
|
|[
|
|
/org/gtk/libgtk=/home/desrt/gtk-overlay
|
|
]|
|
|
|
|
The part before the `=` is the resource subpath for which the overlay applies. The part after is a
|
|
filesystem path which contains files and subdirectories as you would like to be loaded as resources with the
|
|
equivalent names.
|
|
|
|
In the example above, if an application tried to load a resource with the resource path
|
|
`/org/gtk/libgtk/ui/gtkdialog.ui` then GResource would check the filesystem path
|
|
`/home/desrt/gtk-overlay/ui/gtkdialog.ui`. If a file was found there, it would be used instead. This is an
|
|
overlay, not an outright replacement, which means that if a file is not found at that path, the built-in
|
|
version will be used instead. Whiteouts are not currently supported.
|
|
|
|
Substitutions must start with a slash, and must not contain a trailing slash before the '='. The path after
|
|
the slash should ideally be absolute, but this is not strictly required. It is possible to overlay the
|
|
location of a single resource with an individual file.</doc>
|
|
<source-position filename="giotypes.h" line="150"/>
|
|
<constructor name="new_from_data" c:identifier="g_resource_new_from_data" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31693">Creates a GResource from a reference to the binary resource bundle.
|
|
This will keep a reference to @data while the resource lives, so
|
|
the data should not be modified or freed.
|
|
|
|
If you want to use this resource in the global resource namespace you need
|
|
to register it with g_resources_register().
|
|
|
|
Note: @data must be backed by memory that is at least pointer aligned.
|
|
Otherwise this function will internally create a copy of the memory since
|
|
GLib 2.56, or in older versions fail and exit the process.
|
|
|
|
If @data is empty or corrupt, %G_RESOURCE_ERROR_INTERNAL will be returned.</doc>
|
|
<source-position filename="gresource.h" line="65"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31711">a new #GResource, or %NULL on error</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31695">A #GBytes</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="_register" c:identifier="g_resources_register" moved-to="resources_register" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31842">Registers the resource with the process-global set of resources.
|
|
Once a resource is registered the files in it can be accessed
|
|
with the global resource lookup functions like g_resources_lookup_data().</doc>
|
|
<source-position filename="gresource.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31844">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="_unregister" c:identifier="g_resources_unregister" moved-to="resources_unregister" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31854">Unregisters the resource from the process-global set of resources.</doc>
|
|
<source-position filename="gresource.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31856">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="enumerate_children" c:identifier="g_resource_enumerate_children" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31592">Returns all the names of children at the specified @path in the resource.
|
|
The return result is a %NULL terminated list of strings which should
|
|
be released with g_strfreev().
|
|
|
|
If @path is invalid or does not exist in the #GResource,
|
|
%G_RESOURCE_ERROR_NOT_FOUND will be returned.
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="85"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31608">an array of constant strings</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31594">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31595">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31596">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_info" c:identifier="g_resource_get_info" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31623">Looks for a file at the specified @path in the resource and
|
|
if found returns information about it.
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31639">%TRUE if the file was found. %FALSE if there were errors</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31625">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31626">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31627">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31628">a location to place the length of the contents of the file,
|
|
or %NULL if the length is not needed</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="flags" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31630">a location to place the flags about the file,
|
|
or %NULL if the length is not needed</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_data" c:identifier="g_resource_lookup_data" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31665">Looks for a file at the specified @path in the resource and
|
|
returns a #GBytes that lets you directly access the data in
|
|
memory.
|
|
|
|
The data is always followed by a zero byte, so you
|
|
can safely use the data as a C string. However, that byte
|
|
is not included in the size of the GBytes.
|
|
|
|
For uncompressed resource files this is a pointer directly into
|
|
the resource bundle, which is typically in some readonly data section
|
|
in the program binary. For compressed files we allocate memory on
|
|
the heap and automatically uncompress the data.
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="80"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31687">#GBytes or %NULL on error.
|
|
Free the returned object with g_bytes_unref()</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31667">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31668">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31669">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="open_stream" c:identifier="g_resource_open_stream" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31716">Looks for a file at the specified @path in the resource and
|
|
returns a #GInputStream that lets you read the data.
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="75"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31728">#GInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref()</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31718">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31719">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31720">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_resource_ref" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31734">Atomically increments the reference count of @resource by one. This
|
|
function is MT-safe and may be called from any thread.</doc>
|
|
<source-position filename="gresource.h" line="68"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31741">The passed in #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31736">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_resource_unref" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31746">Atomically decrements the reference count of @resource by one. If the
|
|
reference count drops to 0, all memory allocated by the resource is
|
|
released. This function is MT-safe and may be called from any
|
|
thread.</doc>
|
|
<source-position filename="gresource.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31748">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="load" c:identifier="g_resource_load" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31644">Loads a binary resource bundle and creates a #GResource representation of it, allowing
|
|
you to query it for data.
|
|
|
|
If you want to use this resource in the global resource namespace you need
|
|
to register it with g_resources_register().
|
|
|
|
If @filename is empty or the data in it is corrupt,
|
|
%G_RESOURCE_ERROR_INTERNAL will be returned. If @filename doesn’t exist, or
|
|
there is an error in reading it, an error from g_mapped_file_new() will be
|
|
returned.</doc>
|
|
<source-position filename="gresource.h" line="72"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31660">a new #GResource, or %NULL on error</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31646">the path of a filename to load, in the GLib filename encoding</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<enumeration name="ResourceError" version="2.32" glib:type-name="GResourceError" glib:get-type="g_resource_error_get_type" c:type="GResourceError" glib:error-domain="g-resource-error-quark">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="765">An error code used with %G_RESOURCE_ERROR in a #GError returned
|
|
from a #GResource routine.</doc>
|
|
<member name="not_found" value="0" c:identifier="G_RESOURCE_ERROR_NOT_FOUND" glib:nick="not-found">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="767">no file was found at the requested path</doc>
|
|
</member>
|
|
<member name="internal" value="1" c:identifier="G_RESOURCE_ERROR_INTERNAL" glib:nick="internal">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="768">unknown error</doc>
|
|
</member>
|
|
<function name="quark" c:identifier="g_resource_error_quark" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31613">Gets the #GResource Error Quark.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31618">a #GQuark</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
</enumeration>
|
|
<bitfield name="ResourceFlags" version="2.32" glib:type-name="GResourceFlags" glib:get-type="g_resource_flags_get_type" c:type="GResourceFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="780">GResourceFlags give information about a particular file inside a resource
|
|
bundle.</doc>
|
|
<member name="none" value="0" c:identifier="G_RESOURCE_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="782">No flags set.</doc>
|
|
</member>
|
|
<member name="compressed" value="1" c:identifier="G_RESOURCE_FLAGS_COMPRESSED" glib:nick="compressed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="783">The file is compressed.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<bitfield name="ResourceLookupFlags" version="2.32" glib:type-name="GResourceLookupFlags" glib:get-type="g_resource_lookup_flags_get_type" c:type="GResourceLookupFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="795">GResourceLookupFlags determine how resource path lookups are handled.</doc>
|
|
<member name="none" value="0" c:identifier="G_RESOURCE_LOOKUP_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="797">No flags set.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<function-macro name="SEEKABLE" c:identifier="G_SEEKABLE" introspectable="0">
|
|
<source-position filename="gseekable.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SEEKABLE_GET_IFACE" c:identifier="G_SEEKABLE_GET_IFACE" introspectable="0">
|
|
<source-position filename="gseekable.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SETTINGS" c:identifier="G_SETTINGS" introspectable="0">
|
|
<source-position filename="gsettings.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SETTINGS_BACKEND" c:identifier="G_SETTINGS_BACKEND" introspectable="0">
|
|
<source-position filename="gsettingsbackend.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SETTINGS_BACKEND_CLASS" c:identifier="G_SETTINGS_BACKEND_CLASS" introspectable="0">
|
|
<source-position filename="gsettingsbackend.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="SETTINGS_BACKEND_EXTENSION_POINT_NAME" value="gsettings-backend" c:type="G_SETTINGS_BACKEND_EXTENSION_POINT_NAME">
|
|
<doc xml:space="preserve" filename="gsettingsbackend.h" line="47">Extension point for #GSettingsBackend functionality.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="52"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="SETTINGS_BACKEND_GET_CLASS" c:identifier="G_SETTINGS_BACKEND_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsettingsbackend.h" line="44"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SETTINGS_CLASS" c:identifier="G_SETTINGS_CLASS" introspectable="0">
|
|
<source-position filename="gsettings.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SETTINGS_GET_CLASS" c:identifier="G_SETTINGS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsettings.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_ACTION" c:identifier="G_SIMPLE_ACTION" introspectable="0">
|
|
<source-position filename="gsimpleaction.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_ACTION_GROUP" c:identifier="G_SIMPLE_ACTION_GROUP" introspectable="0">
|
|
<source-position filename="gsimpleactiongroup.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_ACTION_GROUP_CLASS" c:identifier="G_SIMPLE_ACTION_GROUP_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleactiongroup.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_ACTION_GROUP_GET_CLASS" c:identifier="G_SIMPLE_ACTION_GROUP_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleactiongroup.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_ASYNC_RESULT" c:identifier="G_SIMPLE_ASYNC_RESULT" introspectable="0">
|
|
<source-position filename="gsimpleasyncresult.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_ASYNC_RESULT_CLASS" c:identifier="G_SIMPLE_ASYNC_RESULT_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleasyncresult.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_ASYNC_RESULT_GET_CLASS" c:identifier="G_SIMPLE_ASYNC_RESULT_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleasyncresult.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_IO_STREAM" c:identifier="G_SIMPLE_IO_STREAM" introspectable="0">
|
|
<source-position filename="gsimpleiostream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_PERMISSION" c:identifier="G_SIMPLE_PERMISSION" introspectable="0">
|
|
<source-position filename="gsimplepermission.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_PROXY_RESOLVER" c:identifier="G_SIMPLE_PROXY_RESOLVER" introspectable="0">
|
|
<source-position filename="gsimpleproxyresolver.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_PROXY_RESOLVER_CLASS" c:identifier="G_SIMPLE_PROXY_RESOLVER_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleproxyresolver.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SIMPLE_PROXY_RESOLVER_GET_CLASS" c:identifier="G_SIMPLE_PROXY_RESOLVER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsimpleproxyresolver.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET" c:identifier="G_SOCKET" introspectable="0">
|
|
<source-position filename="gsocket.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_ADDRESS" c:identifier="G_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="gsocketaddress.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_ADDRESS_CLASS" c:identifier="G_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gsocketaddress.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_ADDRESS_ENUMERATOR" c:identifier="G_SOCKET_ADDRESS_ENUMERATOR" introspectable="0">
|
|
<source-position filename="gsocketaddressenumerator.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_ADDRESS_ENUMERATOR_CLASS" c:identifier="G_SOCKET_ADDRESS_ENUMERATOR_CLASS" introspectable="0">
|
|
<source-position filename="gsocketaddressenumerator.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_ADDRESS_ENUMERATOR_GET_CLASS" c:identifier="G_SOCKET_ADDRESS_ENUMERATOR_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocketaddressenumerator.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_ADDRESS_GET_CLASS" c:identifier="G_SOCKET_ADDRESS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocketaddress.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CLASS" c:identifier="G_SOCKET_CLASS" introspectable="0">
|
|
<source-position filename="gsocket.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CLIENT" c:identifier="G_SOCKET_CLIENT" introspectable="0">
|
|
<source-position filename="gsocketclient.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CLIENT_CLASS" c:identifier="G_SOCKET_CLIENT_CLASS" introspectable="0">
|
|
<source-position filename="gsocketclient.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CLIENT_GET_CLASS" c:identifier="G_SOCKET_CLIENT_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocketclient.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONNECTABLE" c:identifier="G_SOCKET_CONNECTABLE" introspectable="0">
|
|
<source-position filename="gsocketconnectable.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONNECTABLE_GET_IFACE" c:identifier="G_SOCKET_CONNECTABLE_GET_IFACE" introspectable="0">
|
|
<source-position filename="gsocketconnectable.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONNECTION" c:identifier="G_SOCKET_CONNECTION" introspectable="0">
|
|
<source-position filename="gsocketconnection.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONNECTION_CLASS" c:identifier="G_SOCKET_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gsocketconnection.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONNECTION_GET_CLASS" c:identifier="G_SOCKET_CONNECTION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocketconnection.h" line="46"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONTROL_MESSAGE" c:identifier="G_SOCKET_CONTROL_MESSAGE" introspectable="0">
|
|
<source-position filename="gsocketcontrolmessage.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONTROL_MESSAGE_CLASS" c:identifier="G_SOCKET_CONTROL_MESSAGE_CLASS" introspectable="0">
|
|
<source-position filename="gsocketcontrolmessage.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_CONTROL_MESSAGE_GET_CLASS" c:identifier="G_SOCKET_CONTROL_MESSAGE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocketcontrolmessage.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_GET_CLASS" c:identifier="G_SOCKET_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocket.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_LISTENER" c:identifier="G_SOCKET_LISTENER" introspectable="0">
|
|
<source-position filename="gsocketlistener.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_LISTENER_CLASS" c:identifier="G_SOCKET_LISTENER_CLASS" introspectable="0">
|
|
<source-position filename="gsocketlistener.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_LISTENER_GET_CLASS" c:identifier="G_SOCKET_LISTENER_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocketlistener.h" line="46"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_SERVICE" c:identifier="G_SOCKET_SERVICE" introspectable="0">
|
|
<source-position filename="gsocketservice.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_SERVICE_CLASS" c:identifier="G_SOCKET_SERVICE_CLASS" introspectable="0">
|
|
<source-position filename="gsocketservice.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SOCKET_SERVICE_GET_CLASS" c:identifier="G_SOCKET_SERVICE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gsocketservice.h" line="43"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SUBPROCESS" c:identifier="G_SUBPROCESS" introspectable="0">
|
|
<source-position filename="gsubprocess.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="SUBPROCESS_LAUNCHER" c:identifier="G_SUBPROCESS_LAUNCHER" introspectable="0">
|
|
<source-position filename="gsubprocesslauncher.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<interface name="Seekable" c:symbol-prefix="seekable" c:type="GSeekable" glib:type-name="GSeekable" glib:get-type="g_seekable_get_type" glib:type-struct="SeekableIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7599">#GSeekable is implemented by streams (implementations of
|
|
#GInputStream or #GOutputStream) that support seeking.
|
|
|
|
Seekable streams largely fall into two categories: resizable and
|
|
fixed-size.
|
|
|
|
#GSeekable on fixed-sized streams is approximately the same as POSIX
|
|
lseek() on a block device (for example: attempting to seek past the
|
|
end of the device is an error). Fixed streams typically cannot be
|
|
truncated.
|
|
|
|
#GSeekable on resizable streams is approximately the same as POSIX
|
|
lseek() on a normal file. Seeking past the end and writing data will
|
|
usually cause the stream to resize by introducing zero bytes.</doc>
|
|
<source-position filename="gseekable.h" line="77"/>
|
|
<virtual-method name="can_seek" invoker="can_seek">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31864">Tests if the stream supports the #GSeekableIface.</doc>
|
|
<source-position filename="gseekable.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31870">%TRUE if @seekable can be seeked. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31866">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_truncate" invoker="can_truncate">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31874">Tests if the length of the stream can be adjusted with
|
|
g_seekable_truncate().</doc>
|
|
<source-position filename="gseekable.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31881">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31876">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="seek" invoker="seek" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31885">Seeks in the stream by the given @offset, modified by @type.
|
|
|
|
Attempting to seek past the end of the stream will have different
|
|
results depending on if the stream is fixed-sized or resizable. If
|
|
the stream is resizable then seeking past the end and then writing
|
|
will result in zeros filling the empty space. Seeking past the end
|
|
of a resizable stream and reading will result in EOF. Seeking past
|
|
the end of a fixed-sized stream will fail.
|
|
|
|
Any operation that would result in a negative offset will fail.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gseekable.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31909">%TRUE if successful. If an error
|
|
has occurred, this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31887">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31888">a #goffset.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31889">a #GSeekType.</doc>
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31890">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="tell" invoker="tell">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31915">Tells the current position within the stream.</doc>
|
|
<source-position filename="gseekable.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31921">the offset from the beginning of the buffer.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31917">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="truncate_fn" invoker="truncate" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31925">Sets the length of the stream to @offset. If the stream was previously
|
|
larger than @offset, the extra data is discarded. If the stream was
|
|
previouly shorter than @offset, it is extended with NUL ('\0') bytes.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.</doc>
|
|
<source-position filename="gseekable.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31943">%TRUE if successful. If an error
|
|
has occurred, this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31927">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31928">new length for @seekable, in bytes.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31929">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="can_seek" c:identifier="g_seekable_can_seek">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31864">Tests if the stream supports the #GSeekableIface.</doc>
|
|
<source-position filename="gseekable.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31870">%TRUE if @seekable can be seeked. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31866">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_truncate" c:identifier="g_seekable_can_truncate">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31874">Tests if the length of the stream can be adjusted with
|
|
g_seekable_truncate().</doc>
|
|
<source-position filename="gseekable.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31881">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31876">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="seek" c:identifier="g_seekable_seek" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31885">Seeks in the stream by the given @offset, modified by @type.
|
|
|
|
Attempting to seek past the end of the stream will have different
|
|
results depending on if the stream is fixed-sized or resizable. If
|
|
the stream is resizable then seeking past the end and then writing
|
|
will result in zeros filling the empty space. Seeking past the end
|
|
of a resizable stream and reading will result in EOF. Seeking past
|
|
the end of a fixed-sized stream will fail.
|
|
|
|
Any operation that would result in a negative offset will fail.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gseekable.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31909">%TRUE if successful. If an error
|
|
has occurred, this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31887">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31888">a #goffset.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31889">a #GSeekType.</doc>
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31890">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="tell" c:identifier="g_seekable_tell">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31915">Tells the current position within the stream.</doc>
|
|
<source-position filename="gseekable.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31921">the offset from the beginning of the buffer.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31917">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="truncate" c:identifier="g_seekable_truncate" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31925">Sets the length of the stream to @offset. If the stream was previously
|
|
larger than @offset, the extra data is discarded. If the stream was
|
|
previouly shorter than @offset, it is extended with NUL ('\0') bytes.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned. If an
|
|
operation was partially finished when the operation was cancelled the
|
|
partial result will be returned, without an error.</doc>
|
|
<source-position filename="gseekable.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31943">%TRUE if successful. If an error
|
|
has occurred, this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31927">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</instance-parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31928">new length for @seekable, in bytes.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31929">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="SeekableIface" c:type="GSeekableIface" glib:is-gtype-struct-for="Seekable">
|
|
<doc xml:space="preserve" filename="gseekable.h" line="44">Provides an interface for implementing seekable functionality on I/O Streams.</doc>
|
|
<source-position filename="gseekable.h" line="77"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gseekable.h" line="46">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="tell">
|
|
<callback name="tell">
|
|
<source-position filename="gseekable.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31921">the offset from the beginning of the buffer.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31917">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_seek">
|
|
<callback name="can_seek">
|
|
<source-position filename="gseekable.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31870">%TRUE if @seekable can be seeked. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31866">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="seek">
|
|
<callback name="seek" throws="1">
|
|
<source-position filename="gseekable.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31909">%TRUE if successful. If an error
|
|
has occurred, this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31887">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31888">a #goffset.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31889">a #GSeekType.</doc>
|
|
<type name="GLib.SeekType" c:type="GSeekType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31890">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_truncate">
|
|
<callback name="can_truncate">
|
|
<source-position filename="gseekable.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31881">%TRUE if the stream can be truncated, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31876">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="truncate_fn">
|
|
<callback name="truncate_fn" throws="1">
|
|
<source-position filename="gseekable.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31943">%TRUE if successful. If an error
|
|
has occurred, this function will return %FALSE and set @error
|
|
appropriately if present.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="seekable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31927">a #GSeekable.</doc>
|
|
<type name="Seekable" c:type="GSeekable*"/>
|
|
</parameter>
|
|
<parameter name="offset" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31928">new length for @seekable, in bytes.</doc>
|
|
<type name="gint64" c:type="goffset"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31929">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="Settings" c:symbol-prefix="settings" c:type="GSettings" parent="GObject.Object" glib:type-name="GSettings" glib:get-type="g_settings_get_type" glib:type-struct="SettingsClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7622">The #GSettings class provides a convenient API for storing and retrieving
|
|
application settings.
|
|
|
|
Reads and writes can be considered to be non-blocking. Reading
|
|
settings with #GSettings is typically extremely fast: on
|
|
approximately the same order of magnitude (but slower than) a
|
|
#GHashTable lookup. Writing settings is also extremely fast in terms
|
|
of time to return to your application, but can be extremely expensive
|
|
for other threads and other processes. Many settings backends
|
|
(including dconf) have lazy initialisation which means in the common
|
|
case of the user using their computer without modifying any settings
|
|
a lot of work can be avoided. For dconf, the D-Bus service doesn't
|
|
even need to be started in this case. For this reason, you should
|
|
only ever modify #GSettings keys in response to explicit user action.
|
|
Particular care should be paid to ensure that modifications are not
|
|
made during startup -- for example, when setting the initial value
|
|
of preferences widgets. The built-in g_settings_bind() functionality
|
|
is careful not to write settings in response to notify signals as a
|
|
result of modifications that it makes to widgets.
|
|
|
|
When creating a GSettings instance, you have to specify a schema
|
|
that describes the keys in your settings and their types and default
|
|
values, as well as some other information.
|
|
|
|
Normally, a schema has a fixed path that determines where the settings
|
|
are stored in the conceptual global tree of settings. However, schemas
|
|
can also be '[relocatable][gsettings-relocatable]', i.e. not equipped with
|
|
a fixed path. This is
|
|
useful e.g. when the schema describes an 'account', and you want to be
|
|
able to store a arbitrary number of accounts.
|
|
|
|
Paths must start with and end with a forward slash character ('/')
|
|
and must not contain two sequential slash characters. Paths should
|
|
be chosen based on a domain name associated with the program or
|
|
library to which the settings belong. Examples of paths are
|
|
"/org/gtk/settings/file-chooser/" and "/ca/desrt/dconf-editor/".
|
|
Paths should not start with "/apps/", "/desktop/" or "/system/" as
|
|
they often did in GConf.
|
|
|
|
Unlike other configuration systems (like GConf), GSettings does not
|
|
restrict keys to basic types like strings and numbers. GSettings stores
|
|
values as #GVariant, and allows any #GVariantType for keys. Key names
|
|
are restricted to lowercase characters, numbers and '-'. Furthermore,
|
|
the names must begin with a lowercase character, must not end
|
|
with a '-', and must not contain consecutive dashes.
|
|
|
|
Similar to GConf, the default values in GSettings schemas can be
|
|
localized, but the localized values are stored in gettext catalogs
|
|
and looked up with the domain that is specified in the
|
|
`gettext-domain` attribute of the <schemalist> or <schema>
|
|
elements and the category that is specified in the `l10n` attribute of
|
|
the <default> element. The string which is translated includes all text in
|
|
the <default> element, including any surrounding quotation marks.
|
|
|
|
The `l10n` attribute must be set to `messages` or `time`, and sets the
|
|
[locale category for
|
|
translation](https://www.gnu.org/software/gettext/manual/html_node/Aspects.html#index-locale-categories-1).
|
|
The `messages` category should be used by default; use `time` for
|
|
translatable date or time formats. A translation comment can be added as an
|
|
XML comment immediately above the <default> element — it is recommended to
|
|
add these comments to aid translators understand the meaning and
|
|
implications of the default value. An optional translation `context`
|
|
attribute can be set on the <default> element to disambiguate multiple
|
|
defaults which use the same string.
|
|
|
|
For example:
|
|
|[
|
|
<!-- Translators: A list of words which are not allowed to be typed, in
|
|
GVariant serialization syntax.
|
|
See: https://developer.gnome.org/glib/stable/gvariant-text.html -->
|
|
<default l10n='messages' context='Banned words'>['bad', 'words']</default>
|
|
]|
|
|
|
|
Translations of default values must remain syntactically valid serialized
|
|
#GVariants (e.g. retaining any surrounding quotation marks) or runtime
|
|
errors will occur.
|
|
|
|
GSettings uses schemas in a compact binary form that is created
|
|
by the [glib-compile-schemas][glib-compile-schemas]
|
|
utility. The input is a schema description in an XML format.
|
|
|
|
A DTD for the gschema XML format can be found here:
|
|
[gschema.dtd](https://git.gnome.org/browse/glib/tree/gio/gschema.dtd)
|
|
|
|
The [glib-compile-schemas][glib-compile-schemas] tool expects schema
|
|
files to have the extension `.gschema.xml`.
|
|
|
|
At runtime, schemas are identified by their id (as specified in the
|
|
id attribute of the <schema> element). The convention for schema
|
|
ids is to use a dotted name, similar in style to a D-Bus bus name,
|
|
e.g. "org.gnome.SessionManager". In particular, if the settings are
|
|
for a specific service that owns a D-Bus bus name, the D-Bus bus name
|
|
and schema id should match. For schemas which deal with settings not
|
|
associated with one named application, the id should not use
|
|
StudlyCaps, e.g. "org.gnome.font-rendering".
|
|
|
|
In addition to #GVariant types, keys can have types that have
|
|
enumerated types. These can be described by a <choice>,
|
|
<enum> or <flags> element, as seen in the
|
|
[example][schema-enumerated]. The underlying type of such a key
|
|
is string, but you can use g_settings_get_enum(), g_settings_set_enum(),
|
|
g_settings_get_flags(), g_settings_set_flags() access the numeric values
|
|
corresponding to the string value of enum and flags keys.
|
|
|
|
An example for default value:
|
|
|[
|
|
<schemalist>
|
|
<schema id="org.gtk.Test" path="/org/gtk/Test/" gettext-domain="test">
|
|
|
|
<key name="greeting" type="s">
|
|
<default l10n="messages">"Hello, earthlings"</default>
|
|
<summary>A greeting</summary>
|
|
<description>
|
|
Greeting of the invading martians
|
|
</description>
|
|
</key>
|
|
|
|
<key name="box" type="(ii)">
|
|
<default>(20,30)</default>
|
|
</key>
|
|
|
|
<key name="empty-string" type="s">
|
|
<default>""</default>
|
|
<summary>Empty strings have to be provided in GVariant form</summary>
|
|
</key>
|
|
|
|
</schema>
|
|
</schemalist>
|
|
]|
|
|
|
|
An example for ranges, choices and enumerated types:
|
|
|[
|
|
<schemalist>
|
|
|
|
<enum id="org.gtk.Test.myenum">
|
|
<value nick="first" value="1"/>
|
|
<value nick="second" value="2"/>
|
|
</enum>
|
|
|
|
<flags id="org.gtk.Test.myflags">
|
|
<value nick="flag1" value="1"/>
|
|
<value nick="flag2" value="2"/>
|
|
<value nick="flag3" value="4"/>
|
|
</flags>
|
|
|
|
<schema id="org.gtk.Test">
|
|
|
|
<key name="key-with-range" type="i">
|
|
<range min="1" max="100"/>
|
|
<default>10</default>
|
|
</key>
|
|
|
|
<key name="key-with-choices" type="s">
|
|
<choices>
|
|
<choice value='Elisabeth'/>
|
|
<choice value='Annabeth'/>
|
|
<choice value='Joe'/>
|
|
</choices>
|
|
<aliases>
|
|
<alias value='Anna' target='Annabeth'/>
|
|
<alias value='Beth' target='Elisabeth'/>
|
|
</aliases>
|
|
<default>'Joe'</default>
|
|
</key>
|
|
|
|
<key name='enumerated-key' enum='org.gtk.Test.myenum'>
|
|
<default>'first'</default>
|
|
</key>
|
|
|
|
<key name='flags-key' flags='org.gtk.Test.myflags'>
|
|
<default>["flag1","flag2"]</default>
|
|
</key>
|
|
</schema>
|
|
</schemalist>
|
|
]|
|
|
|
|
## Vendor overrides
|
|
|
|
Default values are defined in the schemas that get installed by
|
|
an application. Sometimes, it is necessary for a vendor or distributor
|
|
to adjust these defaults. Since patching the XML source for the schema
|
|
is inconvenient and error-prone,
|
|
[glib-compile-schemas][glib-compile-schemas] reads so-called vendor
|
|
override' files. These are keyfiles in the same directory as the XML
|
|
schema sources which can override default values. The schema id serves
|
|
as the group name in the key file, and the values are expected in
|
|
serialized GVariant form, as in the following example:
|
|
|[
|
|
[org.gtk.Example]
|
|
key1='string'
|
|
key2=1.5
|
|
]|
|
|
|
|
glib-compile-schemas expects schema files to have the extension
|
|
`.gschema.override`.
|
|
|
|
## Binding
|
|
|
|
A very convenient feature of GSettings lets you bind #GObject properties
|
|
directly to settings, using g_settings_bind(). Once a GObject property
|
|
has been bound to a setting, changes on either side are automatically
|
|
propagated to the other side. GSettings handles details like mapping
|
|
between GObject and GVariant types, and preventing infinite cycles.
|
|
|
|
This makes it very easy to hook up a preferences dialog to the
|
|
underlying settings. To make this even more convenient, GSettings
|
|
looks for a boolean property with the name "sensitivity" and
|
|
automatically binds it to the writability of the bound setting.
|
|
If this 'magic' gets in the way, it can be suppressed with the
|
|
#G_SETTINGS_BIND_NO_SENSITIVITY flag.
|
|
|
|
## Relocatable schemas # {#gsettings-relocatable}
|
|
|
|
A relocatable schema is one with no `path` attribute specified on its
|
|
<schema> element. By using g_settings_new_with_path(), a #GSettings object
|
|
can be instantiated for a relocatable schema, assigning a path to the
|
|
instance. Paths passed to g_settings_new_with_path() will typically be
|
|
constructed dynamically from a constant prefix plus some form of instance
|
|
identifier; but they must still be valid GSettings paths. Paths could also
|
|
be constant and used with a globally installed schema originating from a
|
|
dependency library.
|
|
|
|
For example, a relocatable schema could be used to store geometry information
|
|
for different windows in an application. If the schema ID was
|
|
`org.foo.MyApp.Window`, it could be instantiated for paths
|
|
`/org/foo/MyApp/main/`, `/org/foo/MyApp/document-1/`,
|
|
`/org/foo/MyApp/document-2/`, etc. If any of the paths are well-known
|
|
they can be specified as <child> elements in the parent schema, e.g.:
|
|
|[
|
|
<schema id="org.foo.MyApp" path="/org/foo/MyApp/">
|
|
<child name="main" schema="org.foo.MyApp.Window"/>
|
|
</schema>
|
|
]|
|
|
|
|
## Build system integration # {#gsettings-build-system}
|
|
|
|
GSettings comes with autotools integration to simplify compiling and
|
|
installing schemas. To add GSettings support to an application, add the
|
|
following to your `configure.ac`:
|
|
|[
|
|
GLIB_GSETTINGS
|
|
]|
|
|
|
|
In the appropriate `Makefile.am`, use the following snippet to compile and
|
|
install the named schema:
|
|
|[
|
|
gsettings_SCHEMAS = org.foo.MyApp.gschema.xml
|
|
EXTRA_DIST = $(gsettings_SCHEMAS)
|
|
|
|
@GSETTINGS_RULES@
|
|
]|
|
|
|
|
No changes are needed to the build system to mark a schema XML file for
|
|
translation. Assuming it sets the `gettext-domain` attribute, a schema may
|
|
be marked for translation by adding it to `POTFILES.in`, assuming gettext
|
|
0.19 is in use (the preferred method for translation):
|
|
|[
|
|
data/org.foo.MyApp.gschema.xml
|
|
]|
|
|
|
|
Alternatively, if intltool 0.50.1 is in use:
|
|
|[
|
|
[type: gettext/gsettings]data/org.foo.MyApp.gschema.xml
|
|
]|
|
|
|
|
GSettings will use gettext to look up translations for the <summary> and
|
|
<description> elements, and also any <default> elements which have a `l10n`
|
|
attribute set. Translations must not be included in the `.gschema.xml` file
|
|
by the build system, for example by using intltool XML rules with a
|
|
`.gschema.xml.in` template.
|
|
|
|
If an enumerated type defined in a C header file is to be used in a GSettings
|
|
schema, it can either be defined manually using an <enum> element in the
|
|
schema XML, or it can be extracted automatically from the C header. This
|
|
approach is preferred, as it ensures the two representations are always
|
|
synchronised. To do so, add the following to the relevant `Makefile.am`:
|
|
|[
|
|
gsettings_ENUM_NAMESPACE = org.foo.MyApp
|
|
gsettings_ENUM_FILES = my-app-enums.h my-app-misc.h
|
|
]|
|
|
|
|
`gsettings_ENUM_NAMESPACE` specifies the schema namespace for the enum files,
|
|
which are specified in `gsettings_ENUM_FILES`. This will generate a
|
|
`org.foo.MyApp.enums.xml` file containing the extracted enums, which will be
|
|
automatically included in the schema compilation, install and uninstall
|
|
rules. It should not be committed to version control or included in
|
|
`EXTRA_DIST`.</doc>
|
|
<source-position filename="gsettings.h" line="61"/>
|
|
<constructor name="new" c:identifier="g_settings_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32707">Creates a new #GSettings object with the schema specified by
|
|
@schema_id.
|
|
|
|
Signals on the newly created #GSettings object will be dispatched
|
|
via the thread-default #GMainContext in effect at the time of the
|
|
call to g_settings_new(). The new #GSettings will hold a reference
|
|
on the context. See g_main_context_push_thread_default().</doc>
|
|
<source-position filename="gsettings.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32719">a new #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="schema_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32709">the id of the schema</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_full" c:identifier="g_settings_new_full" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32724">Creates a new #GSettings object with a given schema, backend and
|
|
path.
|
|
|
|
It should be extremely rare that you ever want to use this function.
|
|
It is made available for advanced use-cases (such as plugin systems
|
|
that want to provide access to schemas loaded from custom locations,
|
|
etc).
|
|
|
|
At the most basic level, a #GSettings object is a pure composition of
|
|
4 things: a #GSettingsSchema, a #GSettingsBackend, a path within that
|
|
backend, and a #GMainContext to which signals are dispatched.
|
|
|
|
This constructor therefore gives you full control over constructing
|
|
#GSettings instances. The first 3 parameters are given directly as
|
|
@schema, @backend and @path, and the main context is taken from the
|
|
thread-default (as per g_settings_new()).
|
|
|
|
If @backend is %NULL then the default backend is used.
|
|
|
|
If @path is %NULL then the path from the schema is used. It is an
|
|
error if @path is %NULL and the schema has no path of its own or if
|
|
@path is non-%NULL and not equal to the path that the schema does
|
|
have.</doc>
|
|
<source-position filename="gsettings.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32754">a new #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32726">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</parameter>
|
|
<parameter name="backend" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32727">a #GSettingsBackend</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="path" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32728">the path to use</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_with_backend" c:identifier="g_settings_new_with_backend" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32759">Creates a new #GSettings object with the schema specified by
|
|
@schema_id and a given #GSettingsBackend.
|
|
|
|
Creating a #GSettings object with a different backend allows accessing
|
|
settings from a database other than the usual one. For example, it may make
|
|
sense to pass a backend corresponding to the "defaults" settings database on
|
|
the system to get a settings object that modifies the system default
|
|
settings instead of the settings for this user.</doc>
|
|
<source-position filename="gsettings.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32773">a new #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="schema_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32761">the id of the schema</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32762">the #GSettingsBackend to use</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_with_backend_and_path" c:identifier="g_settings_new_with_backend_and_path" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32778">Creates a new #GSettings object with the schema specified by
|
|
@schema_id and a given #GSettingsBackend and path.
|
|
|
|
This is a mix of g_settings_new_with_backend() and
|
|
g_settings_new_with_path().</doc>
|
|
<source-position filename="gsettings.h" line="86"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32790">a new #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="schema_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32780">the id of the schema</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32781">the #GSettingsBackend to use</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32782">the path to use</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_with_path" c:identifier="g_settings_new_with_path" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32795">Creates a new #GSettings object with the relocatable schema specified
|
|
by @schema_id and a given path.
|
|
|
|
You only need to do this if you want to directly create a settings
|
|
object with a schema that doesn't have a specified path of its own.
|
|
That's quite rare.
|
|
|
|
It is a programmer error to call this function for a schema that
|
|
has an explicitly specified path.
|
|
|
|
It is a programmer error if @path is not a valid path. A valid path
|
|
begins and ends with '/' and does not contain two consecutive '/'
|
|
characters.</doc>
|
|
<source-position filename="gsettings.h" line="80"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32814">a new #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="schema_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32797">the id of the schema</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32798">the path to use</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="list_relocatable_schemas" c:identifier="g_settings_list_relocatable_schemas" version="2.28" deprecated="1" deprecated-version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32678">Deprecated.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_settings_schema_source_list_schemas() instead</doc-deprecated>
|
|
<source-position filename="gsettings.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32683">a list of relocatable
|
|
#GSettings schemas that are available, in no defined order. The list must
|
|
not be modified or freed.</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
</function>
|
|
<function name="list_schemas" c:identifier="g_settings_list_schemas" version="2.26" deprecated="1" deprecated-version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32691">Deprecated.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_settings_schema_source_list_schemas() instead.
|
|
If you used g_settings_list_schemas() to check for the presence of
|
|
a particular schema, use g_settings_schema_source_lookup() instead
|
|
of your whole loop.</doc-deprecated>
|
|
<source-position filename="gsettings.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32696">a list of #GSettings
|
|
schemas that are available, in no defined order. The list must not be
|
|
modified or freed.</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
</function>
|
|
<function name="sync" c:identifier="g_settings_sync">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33508">Ensures that all pending operations are complete for the default backend.
|
|
|
|
Writes made to a #GSettings are handled asynchronously. For this
|
|
reason, it is very unlikely that the changes have it to disk by the
|
|
time g_settings_set() returns.
|
|
|
|
This call will block until all of the writes have made it to the
|
|
backend. Since the mainloop is not running, no change notifications
|
|
will be dispatched during this call (but some may be queued by the
|
|
time the call is done).</doc>
|
|
<source-position filename="gsettings.h" line="221"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="unbind" c:identifier="g_settings_unbind" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33524">Removes an existing binding for @property on @object.
|
|
|
|
Note that bindings are automatically removed when the
|
|
object is finalized, so it is rarely necessary to call this
|
|
function.</doc>
|
|
<source-position filename="gsettings.h" line="330"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33526">the object</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="property" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33527">the property whose binding is removed</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="change_event">
|
|
<source-position filename="gsettings.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="keys" transfer-ownership="none">
|
|
<type name="GLib.Quark" c:type="const GQuark*"/>
|
|
</parameter>
|
|
<parameter name="n_keys" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="changed">
|
|
<source-position filename="gsettings.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="writable_change_event">
|
|
<source-position filename="gsettings.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="writable_changed">
|
|
<source-position filename="gsettings.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="apply" c:identifier="g_settings_apply">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31949">Applies any changes that have been made to the settings. This
|
|
function does nothing unless @settings is in 'delay-apply' mode;
|
|
see g_settings_delay(). In the normal case settings are always
|
|
applied immediately.</doc>
|
|
<source-position filename="gsettings.h" line="215"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31951">a #GSettings instance</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="bind" c:identifier="g_settings_bind" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32136">Create a binding between the @key in the @settings object
|
|
and the property @property of @object.
|
|
|
|
The binding uses the default GIO mapping functions to map
|
|
between the settings and property values. These functions
|
|
handle booleans, numeric types and string types in a
|
|
straightforward way. Use g_settings_bind_with_mapping() if
|
|
you need a custom mapping, or map between types that are not
|
|
supported by the default mapping functions.
|
|
|
|
Unless the @flags include %G_SETTINGS_BIND_NO_SENSITIVITY, this
|
|
function also establishes a binding between the writability of
|
|
@key and the "sensitive" property of @object (if @object has
|
|
a boolean property by that name). See g_settings_bind_writable()
|
|
for more details about writable bindings.
|
|
|
|
Note that the lifecycle of the binding is tied to @object,
|
|
and that you can have only one binding per object property.
|
|
If you bind the same property twice on the same object, the second
|
|
binding overrides the first one.</doc>
|
|
<source-position filename="gsettings.h" line="308"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32138">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32139">the key to bind</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32140">a #GObject</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="property" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32141">the name of the property to bind</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32142">flags for the binding</doc>
|
|
<type name="SettingsBindFlags" c:type="GSettingsBindFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="bind_with_mapping" c:identifier="g_settings_bind_with_mapping" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32169">Create a binding between the @key in the @settings object
|
|
and the property @property of @object.
|
|
|
|
The binding uses the provided mapping functions to map between
|
|
settings and property values.
|
|
|
|
Note that the lifecycle of the binding is tied to @object,
|
|
and that you can have only one binding per object property.
|
|
If you bind the same property twice on the same object, the second
|
|
binding overrides the first one.</doc>
|
|
<source-position filename="gsettings.h" line="314"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32171">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32172">the key to bind</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32173">a #GObject</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="property" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32174">the name of the property to bind</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32175">flags for the binding</doc>
|
|
<type name="SettingsBindFlags" c:type="GSettingsBindFlags"/>
|
|
</parameter>
|
|
<parameter name="get_mapping" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32176">a function that gets called to convert values
|
|
from @settings to @object, or %NULL to use the default GIO mapping</doc>
|
|
<type name="SettingsBindGetMapping" c:type="GSettingsBindGetMapping"/>
|
|
</parameter>
|
|
<parameter name="set_mapping" transfer-ownership="none" scope="notified" closure="6" destroy="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32178">a function that gets called to convert values
|
|
from @object to @settings, or %NULL to use the default GIO mapping</doc>
|
|
<type name="SettingsBindSetMapping" c:type="GSettingsBindSetMapping"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32180">data that gets passed to @get_mapping and @set_mapping</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="destroy" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32181">#GDestroyNotify function for @user_data</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="bind_writable" c:identifier="g_settings_bind_writable" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32198">Create a binding between the writability of @key in the
|
|
@settings object and the property @property of @object.
|
|
The property must be boolean; "sensitive" or "visible"
|
|
properties of widgets are the most likely candidates.
|
|
|
|
Writable bindings are always uni-directional; changes of the
|
|
writability of the setting will be propagated to the object
|
|
property, not the other way.
|
|
|
|
When the @inverted argument is %TRUE, the binding inverts the
|
|
value as it passes from the setting to the object, i.e. @property
|
|
will be set to %TRUE if the key is not writable.
|
|
|
|
Note that the lifecycle of the binding is tied to @object,
|
|
and that you can have only one binding per object property.
|
|
If you bind the same property twice on the same object, the second
|
|
binding overrides the first one.</doc>
|
|
<source-position filename="gsettings.h" line="324"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32200">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32201">the key to bind</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32202">a #GObject</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="property" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32203">the name of a boolean property to bind</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="inverted" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32204">whether to 'invert' the value</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_action" c:identifier="g_settings_create_action" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32228">Creates a #GAction corresponding to a given #GSettings key.
|
|
|
|
The action has the same name as the key.
|
|
|
|
The value of the key becomes the state of the action and the action
|
|
is enabled when the key is writable. Changing the state of the
|
|
action results in the key being written to. Changes to the value or
|
|
writability of the key cause appropriate change notifications to be
|
|
emitted for the action.
|
|
|
|
For boolean-valued keys, action activations take no parameter and
|
|
result in the toggling of the value. For all other types,
|
|
activations take the new value for the key (which must have the
|
|
correct type).</doc>
|
|
<source-position filename="gsettings.h" line="334"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32248">a new #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32230">a #GSettings</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32231">the name of a key in @settings</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="delay" c:identifier="g_settings_delay" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32253">Changes the #GSettings object into 'delay-apply' mode. In this
|
|
mode, changes to @settings are not immediately propagated to the
|
|
backend, but kept locally until g_settings_apply() is called.</doc>
|
|
<source-position filename="gsettings.h" line="213"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32255">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get" c:identifier="g_settings_get" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32265">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience function that combines g_settings_get_value() with
|
|
g_variant_get().
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings or for the #GVariantType of @format to mismatch
|
|
the type given in the schema.</doc>
|
|
<source-position filename="gsettings.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32267">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32268">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32269">a #GVariant format string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32270">arguments as per @format</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_boolean" c:identifier="g_settings_get_boolean" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32285">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience variant of g_settings_get() for booleans.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a boolean type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32297">a boolean</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32287">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32288">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_child" c:identifier="g_settings_get_child" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32302">Creates a child settings object which has a base path of
|
|
`base-path/@name`, where `base-path` is the base path of
|
|
@settings.
|
|
|
|
The schema for the child settings object must have been declared
|
|
in the schema of @settings using a <child> element.</doc>
|
|
<source-position filename="gsettings.h" line="205"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32314">a 'child' settings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32304">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32305">the name of the child schema</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_default_value" c:identifier="g_settings_get_default_value" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32319">Gets the "default value" of a key.
|
|
|
|
This is the value that would be read if g_settings_reset() were to be
|
|
called on the key.
|
|
|
|
Note that this may be a different value than returned by
|
|
g_settings_schema_key_get_default_value() if the system administrator
|
|
has provided a default value.
|
|
|
|
Comparing the return values of g_settings_get_default_value() and
|
|
g_settings_get_value() is not sufficient for determining if a value
|
|
has been set because the user may have explicitly set the value to
|
|
something that happens to be equal to the default. The difference
|
|
here is that if the default changes in the future, the user's key
|
|
will still be set.
|
|
|
|
This function may be useful for adding an indication to a UI of what
|
|
the default value was before the user set it.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="117"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32346">the default value</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32321">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32322">the key to get the default value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_double" c:identifier="g_settings_get_double" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32351">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience variant of g_settings_get() for doubles.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a 'double' type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="177"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32363">a double</doc>
|
|
<type name="gdouble" c:type="gdouble"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32353">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32354">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_enum" c:identifier="g_settings_get_enum" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32368">Gets the value that is stored in @settings for @key and converts it
|
|
to the enum value that it represents.
|
|
|
|
In order to use this function the type of the value must be a string
|
|
and it must be marked in the schema file as an enumerated type.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings or is not marked as an enumerated type.
|
|
|
|
If the value stored in the configuration database is not a valid
|
|
value for the enumerated type then this function will return the
|
|
default value.</doc>
|
|
<source-position filename="gsettings.h" line="191"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32386">the enum value</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32370">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32371">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_settings_get_flags" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32391">Gets the value that is stored in @settings for @key and converts it
|
|
to the flags value that it represents.
|
|
|
|
In order to use this function the type of the value must be an array
|
|
of strings and it must be marked in the schema file as an flags type.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings or is not marked as a flags type.
|
|
|
|
If the value stored in the configuration database is not a valid
|
|
value for the flags type then this function will return the default
|
|
value.</doc>
|
|
<source-position filename="gsettings.h" line="198"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32409">the flags value</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32393">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32394">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_has_unapplied" c:identifier="g_settings_get_has_unapplied" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32414">Returns whether the #GSettings object has any unapplied
|
|
changes. This can only be the case if it is in 'delayed-apply' mode.</doc>
|
|
<source-position filename="gsettings.h" line="219"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32421">%TRUE if @settings has unapplied changes</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32416">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int" c:identifier="g_settings_get_int" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32426">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience variant of g_settings_get() for 32-bit integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a int32 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="135"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32438">an integer</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32428">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32429">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_int64" c:identifier="g_settings_get_int64" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32443">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience variant of g_settings_get() for 64-bit integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a int64 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32455">a 64-bit integer</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32445">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32446">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_mapped" c:identifier="g_settings_get_mapped">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32460">Gets the value that is stored at @key in @settings, subject to
|
|
application-level validation/mapping.
|
|
|
|
You should use this function when the application needs to perform
|
|
some processing on the value of the key (for example, parsing). The
|
|
@mapping function performs that processing. If the function
|
|
indicates that the processing was unsuccessful (due to a parse error,
|
|
for example) then the mapping is tried again with another value.
|
|
|
|
This allows a robust 'fall back to defaults' behaviour to be
|
|
implemented somewhat automatically.
|
|
|
|
The first value that is tried is the user's setting for the key. If
|
|
the mapping function fails to map this value, other values may be
|
|
tried in an unspecified order (system or site defaults, translated
|
|
schema default values, untranslated schema default values, etc).
|
|
|
|
If the mapping function fails for all possible values, one additional
|
|
attempt is made: the mapping function is called with a %NULL value.
|
|
If the mapping function still indicates failure at this point then
|
|
the application will be aborted.
|
|
|
|
The result parameter for the @mapping function is pointed to a
|
|
#gpointer which is initially set to %NULL. The same pointer is given
|
|
to each invocation of @mapping. The final value of that #gpointer is
|
|
what is returned by this function. %NULL is valid; it is returned
|
|
just as any other value would be.</doc>
|
|
<source-position filename="gsettings.h" line="338"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32496">the result, which may be %NULL</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32462">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32463">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="mapping" transfer-ownership="none" scope="call" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32464">the function to map the value in the
|
|
settings database to the value used by the application</doc>
|
|
<type name="SettingsGetMapping" c:type="GSettingsGetMapping"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32466">user data for @mapping</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_range" c:identifier="g_settings_get_range" version="2.28" deprecated="1" deprecated-version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32500">Queries the range of a key.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_settings_schema_key_get_range() instead.</doc-deprecated>
|
|
<source-position filename="gsettings.h" line="98"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32502">a #GSettings</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32503">the key to query the range of</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_string" c:identifier="g_settings_get_string" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32512">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience variant of g_settings_get() for strings.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a string type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="163"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32524">a newly-allocated string</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32514">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32515">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_strv" c:identifier="g_settings_get_strv" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32529">A convenience variant of g_settings_get() for string arrays.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having an array of strings type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="184"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32539">a
|
|
newly-allocated, %NULL-terminated array of strings, the value that
|
|
is stored at @key in @settings.</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32531">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32532">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint" c:identifier="g_settings_get_uint" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32546">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience variant of g_settings_get() for 32-bit unsigned
|
|
integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a uint32 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32559">an unsigned integer</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32548">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32549">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uint64" c:identifier="g_settings_get_uint64" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32564">Gets the value that is stored at @key in @settings.
|
|
|
|
A convenience variant of g_settings_get() for 64-bit unsigned
|
|
integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a uint64 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="156"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32577">a 64-bit unsigned integer</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32566">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32567">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_user_value" c:identifier="g_settings_get_user_value" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32582">Checks the "user value" of a key, if there is one.
|
|
|
|
The user value of a key is the last value that was set by the user.
|
|
|
|
After calling g_settings_reset() this function should always return
|
|
%NULL (assuming something is not wrong with the system
|
|
configuration).
|
|
|
|
It is possible that g_settings_get_value() will return a different
|
|
value than this function. This can happen in the case that the user
|
|
set a value for a key that was subsequently locked down by the system
|
|
administrator -- this function will return the user's old value.
|
|
|
|
This function may be useful for adding a "reset" option to a UI or
|
|
for providing indication that a particular value has been changed.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="114"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32606">the user's value, if set</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32584">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32585">the key to get the user value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_value" c:identifier="g_settings_get_value" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32611">Gets the value that is stored in @settings for @key.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="110"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32621">a new #GVariant</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32613">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32614">the key to get the value for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_writable" c:identifier="g_settings_is_writable" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32626">Finds out if a key can be written or not</doc>
|
|
<source-position filename="gsettings.h" line="209"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32633">%TRUE if the key @name is writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32628">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32629">the name of a key</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="list_children" c:identifier="g_settings_list_children">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32638">Gets the list of children on @settings.
|
|
|
|
The list is exactly the list of strings for which it is not an error
|
|
to call g_settings_get_child().
|
|
|
|
There is little reason to call this function from "normal" code, since
|
|
you should already know what children are in your schema. This function
|
|
may still be useful there for introspection reasons, however.
|
|
|
|
You should free the return value with g_strfreev() when you are done
|
|
with it.</doc>
|
|
<source-position filename="gsettings.h" line="94"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32654">a list of the children on
|
|
@settings, in no defined order</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32640">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="list_keys" c:identifier="g_settings_list_keys" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32659">Introspects the list of keys on @settings.
|
|
|
|
You should probably not be calling this function from "normal" code
|
|
(since you should already know what keys are in your schema). This
|
|
function is intended for introspection reasons.
|
|
|
|
You should free the return value with g_strfreev() when you are done
|
|
with it.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_settings_schema_list_keys instead().</doc-deprecated>
|
|
<source-position filename="gsettings.h" line="96"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32672">a list of the keys on
|
|
@settings, in no defined order</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32661">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="range_check" c:identifier="g_settings_range_check" version="2.28" deprecated="1" deprecated-version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32819">Checks if the given @value is of the correct type and within the
|
|
permitted range for @key.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_settings_schema_key_range_check() instead.</doc-deprecated>
|
|
<source-position filename="gsettings.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32828">%TRUE if @value is valid for @key</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32821">a #GSettings</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32822">the key to check</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32823">the value to check</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="reset" c:identifier="g_settings_reset">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32834">Resets @key to its default value.
|
|
|
|
This call resets the key, as much as possible, to its default value.
|
|
That might be the value specified in the schema or the one set by the
|
|
administrator.</doc>
|
|
<source-position filename="gsettings.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32836">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32837">the name of a key</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="revert" c:identifier="g_settings_revert">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32847">Reverts all non-applied changes to the settings. This function
|
|
does nothing unless @settings is in 'delay-apply' mode; see
|
|
g_settings_delay(). In the normal case settings are always applied
|
|
immediately.
|
|
|
|
Change notifications will be emitted for affected keys.</doc>
|
|
<source-position filename="gsettings.h" line="217"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32849">a #GSettings instance</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set" c:identifier="g_settings_set" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33268">Sets @key in @settings to @value.
|
|
|
|
A convenience function that combines g_settings_set_value() with
|
|
g_variant_new().
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings or for the #GVariantType of @format to mismatch
|
|
the type given in the schema.</doc>
|
|
<source-position filename="gsettings.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33284">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33270">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33271">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33272">a #GVariant format string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33273">arguments as per @format</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_boolean" c:identifier="g_settings_set_boolean" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33290">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for booleans.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a boolean type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="173"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33303">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33292">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33293">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33294">the value to set it to</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_double" c:identifier="g_settings_set_double" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33309">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for doubles.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a 'double' type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="180"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33322">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33311">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33312">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33313">the value to set it to</doc>
|
|
<type name="gdouble" c:type="gdouble"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_enum" c:identifier="g_settings_set_enum">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33328">Looks up the enumerated type nick for @value and writes it to @key,
|
|
within @settings.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings or is not marked as an enumerated type, or for
|
|
@value not to be a valid value for the named type.
|
|
|
|
After performing the write, accessing @key directly with
|
|
g_settings_get_string() will return the 'nick' associated with
|
|
@value.</doc>
|
|
<source-position filename="gsettings.h" line="194"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33345">%TRUE, if the set succeeds</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33330">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33331">a key, within @settings</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33332">an enumerated value</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flags" c:identifier="g_settings_set_flags">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33349">Looks up the flags type nicks for the bits specified by @value, puts
|
|
them in an array of strings and writes the array to @key, within
|
|
@settings.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings or is not marked as a flags type, or for @value
|
|
to contain any bits that are not value for the named type.
|
|
|
|
After performing the write, accessing @key directly with
|
|
g_settings_get_strv() will return an array of 'nicks'; one for each
|
|
bit in @value.</doc>
|
|
<source-position filename="gsettings.h" line="201"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33367">%TRUE, if the set succeeds</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33351">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33352">a key, within @settings</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33353">a flags value</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_int" c:identifier="g_settings_set_int" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33371">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for 32-bit integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a int32 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33384">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33373">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33374">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33375">the value to set it to</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_int64" c:identifier="g_settings_set_int64" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33390">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for 64-bit integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a int64 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33403">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33392">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33393">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33394">the value to set it to</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_string" c:identifier="g_settings_set_string" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33409">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for strings.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a string type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33422">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33411">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33412">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33413">the value to set it to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_strv" c:identifier="g_settings_set_strv" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33428">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for string arrays. If
|
|
@value is %NULL, then @key is set to be the empty array.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having an array of strings type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="187"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33442">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33430">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33431">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33432">the value to set it to, or %NULL</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_uint" c:identifier="g_settings_set_uint" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33448">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for 32-bit unsigned
|
|
integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a uint32 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="152"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33462">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33450">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33451">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33452">the value to set it to</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_uint64" c:identifier="g_settings_set_uint64" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33468">Sets @key in @settings to @value.
|
|
|
|
A convenience variant of g_settings_set() for 64-bit unsigned
|
|
integers.
|
|
|
|
It is a programmer error to give a @key that isn't specified as
|
|
having a uint64 type in the schema for @settings.</doc>
|
|
<source-position filename="gsettings.h" line="159"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33482">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33470">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33471">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33472">the value to set it to</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_value" c:identifier="g_settings_set_value" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33488">Sets @key in @settings to @value.
|
|
|
|
It is a programmer error to give a @key that isn't contained in the
|
|
schema for @settings or for @value to have the incorrect type, per
|
|
the schema.
|
|
|
|
If @value is floating then this function consumes the reference.</doc>
|
|
<source-position filename="gsettings.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33502">%TRUE if setting the key succeeded,
|
|
%FALSE if the key was not writable</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="settings" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33490">a #GSettings object</doc>
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33491">the name of the key to set</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33492">a #GVariant of the correct type</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="backend" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2924">The name of the context that the settings are stored in.</doc>
|
|
<type name="SettingsBackend"/>
|
|
</property>
|
|
<property name="delay-apply" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2931">Whether the #GSettings object is in 'delay-apply' mode. See
|
|
g_settings_delay() for details.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="has-unapplied" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2941">If this property is %TRUE, the #GSettings object has outstanding
|
|
changes that will be applied when g_settings_apply() is called.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="path" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2949">The path within the backend where the settings are stored.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="schema" deprecated="1" deprecated-version="2.32" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2956">The name of the schema that describes the types of keys
|
|
for this #GSettings object.
|
|
|
|
The type of this property is *not* #GSettingsSchema.
|
|
#GSettingsSchema has only existed since version 2.32 and
|
|
unfortunately this name was used in previous versions to refer to
|
|
the schema ID rather than the schema itself. Take care to use the
|
|
'settings-schema' property if you wish to pass in a
|
|
#GSettingsSchema.</doc>
|
|
<doc-deprecated xml:space="preserve">Use the 'schema-id' property instead. In a future
|
|
version, this property may instead refer to a #GSettingsSchema.</doc-deprecated>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="schema-id" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2974">The name of the schema that describes the types of keys
|
|
for this #GSettings object.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="settings-schema" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2982">The #GSettingsSchema describing the types of keys for this
|
|
#GSettings object.
|
|
|
|
Ideally, this property would be called 'schema'. #GSettingsSchema
|
|
has only existed since version 2.32, however, and before then the
|
|
'schema' property was used to refer to the ID of the schema rather
|
|
than the schema itself. Take care.</doc>
|
|
<type name="SettingsSchema"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="SettingsPrivate" c:type="GSettingsPrivate*"/>
|
|
</field>
|
|
<glib:signal name="change-event" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2834">The "change-event" signal is emitted once per change event that
|
|
affects this settings object. You should connect to this signal
|
|
only if you are interested in viewing groups of changes before they
|
|
are split out into multiple emissions of the "changed" signal.
|
|
For most use cases it is more appropriate to use the "changed" signal.
|
|
|
|
In the event that the change event applies to one or more specified
|
|
keys, @keys will be an array of #GQuark of length @n_keys. In the
|
|
event that the change event applies to the #GSettings object as a
|
|
whole (ie: potentially every key has been changed) then @keys will
|
|
be %NULL and @n_keys will be 0.
|
|
|
|
The default handler for this signal invokes the "changed" signal
|
|
for each affected key. If any other connected handler returns
|
|
%TRUE then this default functionality will be suppressed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2857">%TRUE to stop other handlers from being invoked for the
|
|
event. FALSE to propagate the event further.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="keys" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2837">
|
|
an array of #GQuarks for the changed keys, or %NULL</doc>
|
|
<array length="1" zero-terminated="0" c:type="gpointer">
|
|
<type name="GLib.Quark"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_keys" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2839">the length of the @keys array, or 0</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="changed" when="last" detailed="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2862">The "changed" signal is emitted when a key has potentially changed.
|
|
You should call one of the g_settings_get() calls to check the new
|
|
value.
|
|
|
|
This signal supports detailed connections. You can connect to the
|
|
detailed signal "changed::x" in order to only receive callbacks
|
|
when key "x" changes.
|
|
|
|
Note that @settings only emits this signal if you have read @key at
|
|
least once while a signal handler was already connected for @key.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2865">the name of the key that changed</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="writable-change-event" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2880">The "writable-change-event" signal is emitted once per writability
|
|
change event that affects this settings object. You should connect
|
|
to this signal if you are interested in viewing groups of changes
|
|
before they are split out into multiple emissions of the
|
|
"writable-changed" signal. For most use cases it is more
|
|
appropriate to use the "writable-changed" signal.
|
|
|
|
In the event that the writability change applies only to a single
|
|
key, @key will be set to the #GQuark for that key. In the event
|
|
that the writability change affects the entire settings object,
|
|
@key will be 0.
|
|
|
|
The default handler for this signal invokes the "writable-changed"
|
|
and "changed" signals for each affected key. This is done because
|
|
changes in writability might also imply changes in value (if for
|
|
example, a new mandatory setting is introduced). If any other
|
|
connected handler returns %TRUE then this default functionality
|
|
will be suppressed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2904">%TRUE to stop other handlers from being invoked for the
|
|
event. FALSE to propagate the event further.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2883">the quark of the key, or 0</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="writable-changed" when="last" detailed="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2909">The "writable-changed" signal is emitted when the writability of a
|
|
key has potentially changed. You should call
|
|
g_settings_is_writable() in order to determine the new status.
|
|
|
|
This signal supports detailed connections. You can connect to the
|
|
detailed signal "writable-changed::x" in order to only receive
|
|
callbacks when the writability of "x" changes.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="2912">the key</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<class name="SettingsBackend" c:symbol-prefix="settings_backend" c:type="GSettingsBackend" parent="GObject.Object" abstract="1" glib:type-name="GSettingsBackend" glib:get-type="g_settings_backend_get_type" glib:type-struct="SettingsBackendClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7917">The #GSettingsBackend interface defines a generic interface for
|
|
non-strictly-typed data that is stored in a hierarchy. To implement
|
|
an alternative storage backend for #GSettings, you need to implement
|
|
the #GSettingsBackend interface and then make it implement the
|
|
extension point #G_SETTINGS_BACKEND_EXTENSION_POINT_NAME.
|
|
|
|
The interface defines methods for reading and writing values, a
|
|
method for determining if writing of certain values will fail
|
|
(lockdown) and a change notification mechanism.
|
|
|
|
The semantics of the interface are very precisely defined and
|
|
implementations must carefully adhere to the expectations of
|
|
callers that are documented on each of the interface methods.
|
|
|
|
Some of the #GSettingsBackend functions accept or return a #GTree.
|
|
These trees always have strings as keys and #GVariant as values.
|
|
g_settings_backend_create_tree() is a convenience function to create
|
|
suitable trees.
|
|
|
|
The #GSettingsBackend API is exported to allow third-party
|
|
implementations, but does not carry the same stability guarantees
|
|
as the public GIO API. For this reason, you have to define the
|
|
C preprocessor symbol %G_SETTINGS_ENABLE_BACKEND before including
|
|
`gio/gsettingsbackend.h`.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="115"/>
|
|
<function name="flatten_tree" c:identifier="g_settings_backend_flatten_tree" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32007">Calculate the longest common prefix of all keys in a tree and write
|
|
out an array of the key names relative to that prefix and,
|
|
optionally, the value to store at each of those keys.
|
|
|
|
You must free the value returned in @path, @keys and @values using
|
|
g_free(). You should not attempt to free or unref the contents of
|
|
@keys or @values.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="tree" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32009">a #GTree containing the changes</doc>
|
|
<type name="GLib.Tree" c:type="GTree*"/>
|
|
</parameter>
|
|
<parameter name="path" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32010">the location to save the path</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
<parameter name="keys" direction="out" caller-allocates="0" transfer-ownership="container">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32011">the
|
|
location to save the relative keys</doc>
|
|
<array c:type="const gchar***">
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="values" direction="out" caller-allocates="0" transfer-ownership="container" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32013">
|
|
the location to save the values, or %NULL</doc>
|
|
<array c:type="GVariant***">
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get_default" c:identifier="g_settings_backend_get_default" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32028">Returns the default #GSettingsBackend. It is possible to override
|
|
the default by setting the `GSETTINGS_BACKEND` environment variable
|
|
to the name of a settings backend.
|
|
|
|
The user gets a reference to the backend.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="159"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32037">the default #GSettingsBackend</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="get_permission" introspectable="0">
|
|
<source-position filename="gsettingsbackend.h" line="106"/>
|
|
<return-value>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_writable">
|
|
<source-position filename="gsettingsbackend.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read">
|
|
<source-position filename="gsettingsbackend.h" line="81"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none">
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="default_value" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="read_user_value">
|
|
<source-position filename="gsettingsbackend.h" line="109"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none">
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="reset">
|
|
<source-position filename="gsettingsbackend.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="subscribe">
|
|
<source-position filename="gsettingsbackend.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="sync">
|
|
<source-position filename="gsettingsbackend.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="unsubscribe">
|
|
<source-position filename="gsettingsbackend.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="write">
|
|
<source-position filename="gsettingsbackend.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="write_tree">
|
|
<source-position filename="gsettingsbackend.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="tree" transfer-ownership="none">
|
|
<type name="GLib.Tree" c:type="GTree*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="changed" c:identifier="g_settings_backend_changed" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31960">Signals that a single key has possibly changed. Backend
|
|
implementations should call this if a key has possibly changed its
|
|
value.
|
|
|
|
@key must be a valid key (ie starting with a slash, not containing
|
|
'//', and not ending with a slash).
|
|
|
|
The implementation must call this function during any call to
|
|
g_settings_backend_write(), before the call returns (except in the
|
|
case that no keys are actually changed and it cares to detect this
|
|
fact). It may not rely on the existence of a mainloop for
|
|
dispatching the signal later.
|
|
|
|
The implementation may call this function at any other time it likes
|
|
in response to other events (such as changes occurring outside of the
|
|
program). These calls may originate from a mainloop or may originate
|
|
in response to any other action (including from calls to
|
|
g_settings_backend_write()).
|
|
|
|
In the case that this call is in response to a call to
|
|
g_settings_backend_write() then @origin_tag must be set to the same
|
|
value that was passed to that call.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31962">a #GSettingsBackend implementation</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31963">the name of the key</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31964">the origin tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="changed_tree" c:identifier="g_settings_backend_changed_tree" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31993">This call is a convenience wrapper. It gets the list of changes from
|
|
@tree, computes the longest common prefix and calls
|
|
g_settings_backend_changed().</doc>
|
|
<source-position filename="gsettingsbackend.h" line="154"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31995">a #GSettingsBackend implementation</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="tree" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31996">a #GTree containing the changes</doc>
|
|
<type name="GLib.Tree" c:type="GTree*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31997">the origin tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="keys_changed" c:identifier="g_settings_backend_keys_changed" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32042">Signals that a list of keys have possibly changed. Backend
|
|
implementations should call this if keys have possibly changed their
|
|
values.
|
|
|
|
@path must be a valid path (ie starting and ending with a slash and
|
|
not containing '//'). Each string in @items must form a valid key
|
|
name when @path is prefixed to it (ie: each item must not start or
|
|
end with '/' and must not contain '//').
|
|
|
|
The meaning of this signal is that any of the key names resulting
|
|
from the contatenation of @path with each item in @items may have
|
|
changed.
|
|
|
|
The same rules for when notifications must occur apply as per
|
|
g_settings_backend_changed(). These two calls can be used
|
|
interchangeably if exactly one item has changed (although in that
|
|
case g_settings_backend_changed() is definitely preferred).
|
|
|
|
For efficiency reasons, the implementation should strive for @path to
|
|
be as long as possible (ie: the longest common prefix of all of the
|
|
keys that were changed) but this is not strictly required.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32044">a #GSettingsBackend implementation</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32045">the path containing the changes</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="items" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32046">the %NULL-terminated list of changed keys</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32047">the origin tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="path_changed" c:identifier="g_settings_backend_path_changed" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32075">Signals that all keys below a given path may have possibly changed.
|
|
Backend implementations should call this if an entire path of keys
|
|
have possibly changed their values.
|
|
|
|
@path must be a valid path (ie starting and ending with a slash and
|
|
not containing '//').
|
|
|
|
The meaning of this signal is that any of the key which has a name
|
|
starting with @path may have changed.
|
|
|
|
The same rules for when notifications must occur apply as per
|
|
g_settings_backend_changed(). This call might be an appropriate
|
|
reasponse to a 'reset' call but implementations are also free to
|
|
explicitly list the keys that were affected by that call if they can
|
|
easily do so.
|
|
|
|
For efficiency reasons, the implementation should strive for @path to
|
|
be as long as possible (ie: the longest common prefix of all of the
|
|
keys that were changed) but this is not strictly required. As an
|
|
example, if this function is called with the path of "/" then every
|
|
single key in the application will be notified of a possible change.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="133"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32077">a #GSettingsBackend implementation</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32078">the path containing the changes</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32079">the origin tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="path_writable_changed" c:identifier="g_settings_backend_path_writable_changed" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32107">Signals that the writability of all keys below a given path may have
|
|
changed.
|
|
|
|
Since GSettings performs no locking operations for itself, this call
|
|
will always be made in response to external events.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="148"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32109">a #GSettingsBackend implementation</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32110">the name of the path</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="writable_changed" c:identifier="g_settings_backend_writable_changed" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32122">Signals that the writability of a single key has possibly changed.
|
|
|
|
Since GSettings performs no locking operations for itself, this call
|
|
will always be made in response to external events.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="151"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32124">a #GSettingsBackend implementation</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32125">the name of the key</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="SettingsBackendPrivate" c:type="GSettingsBackendPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="SettingsBackendClass" c:type="GSettingsBackendClass" glib:is-gtype-struct-for="SettingsBackend">
|
|
<doc xml:space="preserve" filename="gsettingsbackend.h" line="62">Class structure for #GSettingsBackend.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="115"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="read">
|
|
<callback name="read">
|
|
<source-position filename="gsettingsbackend.h" line="81"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none">
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="default_value" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_writable">
|
|
<callback name="get_writable">
|
|
<source-position filename="gsettingsbackend.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="write">
|
|
<callback name="write">
|
|
<source-position filename="gsettingsbackend.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="write_tree">
|
|
<callback name="write_tree">
|
|
<source-position filename="gsettingsbackend.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="tree" transfer-ownership="none">
|
|
<type name="GLib.Tree" c:type="GTree*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="reset">
|
|
<callback name="reset">
|
|
<source-position filename="gsettingsbackend.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="origin_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="subscribe">
|
|
<callback name="subscribe">
|
|
<source-position filename="gsettingsbackend.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="unsubscribe">
|
|
<callback name="unsubscribe">
|
|
<source-position filename="gsettingsbackend.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="sync">
|
|
<callback name="sync">
|
|
<source-position filename="gsettingsbackend.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_permission" introspectable="0">
|
|
<callback name="get_permission" introspectable="0">
|
|
<source-position filename="gsettingsbackend.h" line="106"/>
|
|
<return-value>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="read_user_value">
|
|
<callback name="read_user_value">
|
|
<source-position filename="gsettingsbackend.h" line="109"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none">
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="23">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="SettingsBackendPrivate" c:type="GSettingsBackendPrivate" disguised="1">
|
|
<source-position filename="gsettingsbackend.h" line="59"/>
|
|
</record>
|
|
<bitfield name="SettingsBindFlags" glib:type-name="GSettingsBindFlags" glib:get-type="g_settings_bind_flags_get_type" c:type="GSettingsBindFlags">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="279">Flags used when creating a binding. These flags determine in which
|
|
direction the binding works. The default is to synchronize in both
|
|
directions.</doc>
|
|
<member name="default" value="0" c:identifier="G_SETTINGS_BIND_DEFAULT" glib:nick="default">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="281">Equivalent to `G_SETTINGS_BIND_GET|G_SETTINGS_BIND_SET`</doc>
|
|
</member>
|
|
<member name="get" value="1" c:identifier="G_SETTINGS_BIND_GET" glib:nick="get">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="282">Update the #GObject property when the setting changes.
|
|
It is an error to use this flag if the property is not writable.</doc>
|
|
</member>
|
|
<member name="set" value="2" c:identifier="G_SETTINGS_BIND_SET" glib:nick="set">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="284">Update the setting when the #GObject property changes.
|
|
It is an error to use this flag if the property is not readable.</doc>
|
|
</member>
|
|
<member name="no_sensitivity" value="4" c:identifier="G_SETTINGS_BIND_NO_SENSITIVITY" glib:nick="no-sensitivity">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="286">Do not try to bind a "sensitivity" property to the writability of the setting</doc>
|
|
</member>
|
|
<member name="get_no_changes" value="8" c:identifier="G_SETTINGS_BIND_GET_NO_CHANGES" glib:nick="get-no-changes">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="287">When set in addition to #G_SETTINGS_BIND_GET, set the #GObject property
|
|
value initially from the setting, but do not listen for changes of the setting</doc>
|
|
</member>
|
|
<member name="invert_boolean" value="16" c:identifier="G_SETTINGS_BIND_INVERT_BOOLEAN" glib:nick="invert-boolean">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="289">When passed to g_settings_bind(), uses a pair of mapping functions that invert
|
|
the boolean value when mapping between the setting and the property. The setting and property must both
|
|
be booleans. You cannot pass this flag to g_settings_bind_with_mapping().</doc>
|
|
</member>
|
|
</bitfield>
|
|
<callback name="SettingsBindGetMapping" c:type="GSettingsBindGetMapping">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="239">The type for the function that is used to convert from #GSettings to
|
|
an object property. The @value is already initialized to hold values
|
|
of the appropriate type.</doc>
|
|
<source-position filename="gsettings.h" line="251"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="249">%TRUE if the conversion succeeded, %FALSE in case of an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="241">return location for the property value</doc>
|
|
<type name="GObject.Value" c:type="GValue*"/>
|
|
</parameter>
|
|
<parameter name="variant" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="242">the #GVariant</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="243">user data that was specified when the binding was created</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<callback name="SettingsBindSetMapping" c:type="GSettingsBindSetMapping">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="223">The type for the function that is used to convert an object property
|
|
value to a #GVariant for storing it in #GSettings.</doc>
|
|
<source-position filename="gsettings.h" line="235"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="232">a new #GVariant holding the data from @value,
|
|
or %NULL in case of an error</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="225">a #GValue containing the property value to map</doc>
|
|
<type name="GObject.Value" c:type="const GValue*"/>
|
|
</parameter>
|
|
<parameter name="expected_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="226">the #GVariantType to create</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="227">user data that was specified when the binding was created</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="SettingsClass" c:type="GSettingsClass" glib:is-gtype-struct-for="Settings">
|
|
<source-position filename="gsettings.h" line="61"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="writable_changed">
|
|
<callback name="writable_changed">
|
|
<source-position filename="gsettings.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="changed">
|
|
<callback name="changed">
|
|
<source-position filename="gsettings.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="writable_change_event">
|
|
<callback name="writable_change_event">
|
|
<source-position filename="gsettings.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</parameter>
|
|
<parameter name="key" transfer-ownership="none">
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="change_event">
|
|
<callback name="change_event">
|
|
<source-position filename="gsettings.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="settings" transfer-ownership="none">
|
|
<type name="Settings" c:type="GSettings*"/>
|
|
</parameter>
|
|
<parameter name="keys" transfer-ownership="none">
|
|
<type name="GLib.Quark" c:type="const GQuark*"/>
|
|
</parameter>
|
|
<parameter name="n_keys" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding">
|
|
<array zero-terminated="0" fixed-size="20">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<callback name="SettingsGetMapping" c:type="GSettingsGetMapping">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="255">The type of the function that is used to convert from a value stored
|
|
in a #GSettings to a value that is useful to the application.
|
|
|
|
If the value is successfully mapped, the result should be stored at
|
|
@result and %TRUE returned. If mapping fails (for example, if @value
|
|
is not in the right format) then %FALSE should be returned.
|
|
|
|
If @value is %NULL then it means that the mapping function is being
|
|
given a "last chance" to successfully return a valid value. %TRUE
|
|
must be returned in this case.</doc>
|
|
<source-position filename="gsettings.h" line="275"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="273">%TRUE if the conversion succeeded, %FALSE in case of an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="257">the #GVariant to map, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="result" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="258">the result of the mapping</doc>
|
|
<type name="gpointer" c:type="gpointer*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gsettings.h" line="259">the user data that was passed to
|
|
g_settings_get_mapped()</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<record name="SettingsPrivate" c:type="GSettingsPrivate" disguised="1">
|
|
<source-position filename="gsettings.h" line="42"/>
|
|
</record>
|
|
<record name="SettingsSchema" c:type="GSettingsSchema" version="2.32" glib:type-name="GSettingsSchema" glib:get-type="g_settings_schema_get_type" c:symbol-prefix="settings_schema">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="7951">The #GSettingsSchemaSource and #GSettingsSchema APIs provide a
|
|
mechanism for advanced control over the loading of schemas and a
|
|
mechanism for introspecting their content.
|
|
|
|
Plugin loading systems that wish to provide plugins a way to access
|
|
settings face the problem of how to make the schemas for these
|
|
settings visible to GSettings. Typically, a plugin will want to ship
|
|
the schema along with itself and it won't be installed into the
|
|
standard system directories for schemas.
|
|
|
|
#GSettingsSchemaSource provides a mechanism for dealing with this by
|
|
allowing the creation of a new 'schema source' from which schemas can
|
|
be acquired. This schema source can then become part of the metadata
|
|
associated with the plugin and queried whenever the plugin requires
|
|
access to some settings.
|
|
|
|
Consider the following example:
|
|
|
|
|[<!-- language="C" -->
|
|
typedef struct
|
|
{
|
|
...
|
|
GSettingsSchemaSource *schema_source;
|
|
...
|
|
} Plugin;
|
|
|
|
Plugin *
|
|
initialise_plugin (const gchar *dir)
|
|
{
|
|
Plugin *plugin;
|
|
|
|
...
|
|
|
|
plugin->schema_source =
|
|
g_settings_schema_source_new_from_directory (dir,
|
|
g_settings_schema_source_get_default (), FALSE, NULL);
|
|
|
|
...
|
|
|
|
return plugin;
|
|
}
|
|
|
|
...
|
|
|
|
GSettings *
|
|
plugin_get_settings (Plugin *plugin,
|
|
const gchar *schema_id)
|
|
{
|
|
GSettingsSchema *schema;
|
|
|
|
if (schema_id == NULL)
|
|
schema_id = plugin->identifier;
|
|
|
|
schema = g_settings_schema_source_lookup (plugin->schema_source,
|
|
schema_id, FALSE);
|
|
|
|
if (schema == NULL)
|
|
{
|
|
... disable the plugin or abort, etc ...
|
|
}
|
|
|
|
return g_settings_new_full (schema, NULL, NULL);
|
|
}
|
|
]|
|
|
|
|
The code above shows how hooks should be added to the code that
|
|
initialises (or enables) the plugin to create the schema source and
|
|
how an API can be added to the plugin system to provide a convenient
|
|
way for the plugin to access its settings, using the schemas that it
|
|
ships.
|
|
|
|
From the standpoint of the plugin, it would need to ensure that it
|
|
ships a gschemas.compiled file as part of itself, and then simply do
|
|
the following:
|
|
|
|
|[<!-- language="C" -->
|
|
{
|
|
GSettings *settings;
|
|
gint some_value;
|
|
|
|
settings = plugin_get_settings (self, NULL);
|
|
some_value = g_settings_get_int (settings, "some-value");
|
|
...
|
|
}
|
|
]|
|
|
|
|
It's also possible that the plugin system expects the schema source
|
|
files (ie: .gschema.xml files) instead of a gschemas.compiled file.
|
|
In that case, the plugin loading system must compile the schemas for
|
|
itself before attempting to create the settings source.</doc>
|
|
<source-position filename="gsettingsschema.h" line="27"/>
|
|
<method name="get_id" c:identifier="g_settings_schema_get_id">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32860">Get the ID of @schema.</doc>
|
|
<source-position filename="gsettingsschema.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32866">the ID</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32862">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_key" c:identifier="g_settings_schema_get_key" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32870">Gets the key named @name from @schema.
|
|
|
|
It is a programmer error to request a key that does not exist. See
|
|
g_settings_schema_list_keys().</doc>
|
|
<source-position filename="gsettingsschema.h" line="72"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32880">the #GSettingsSchemaKey for @name</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32872">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32873">the name of a key</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_path" c:identifier="g_settings_schema_get_path" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32885">Gets the path associated with @schema, or %NULL.
|
|
|
|
Schemas may be single-instance or relocatable. Single-instance
|
|
schemas correspond to exactly one set of keys in the backend
|
|
database: those located at the path returned by this function.
|
|
|
|
Relocatable schemas can be referenced by other schemas and can
|
|
threfore describe multiple sets of keys at different locations. For
|
|
relocatable schemas, this function will return %NULL.</doc>
|
|
<source-position filename="gsettingsschema.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32899">the path of the schema, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32887">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="has_key" c:identifier="g_settings_schema_has_key" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32904">Checks if @schema has a key named @name.</doc>
|
|
<source-position filename="gsettingsschema.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32911">%TRUE if such a key exists</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32906">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32907">the name of a key</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="list_children" c:identifier="g_settings_schema_list_children" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33082">Gets the list of children in @schema.
|
|
|
|
You should free the return value with g_strfreev() when you are done
|
|
with it.</doc>
|
|
<source-position filename="gsettingsschema.h" line="82"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33091">a list of the children on
|
|
@settings, in no defined order</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33084">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="list_keys" c:identifier="g_settings_schema_list_keys" version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33097">Introspects the list of keys on @schema.
|
|
|
|
You should probably not be calling this function from "normal" code
|
|
(since you should already know what keys are in your schema). This
|
|
function is intended for introspection reasons.</doc>
|
|
<source-position filename="gsettingsschema.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33107">a list of the keys on
|
|
@schema, in no defined order</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33099">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_settings_schema_ref" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33113">Increase the reference count of @schema, returning a new reference.</doc>
|
|
<source-position filename="gsettingsschema.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33119">a new reference to @schema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33115">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_settings_schema_unref" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33258">Decrease the reference count of @schema, possibly freeing it.</doc>
|
|
<source-position filename="gsettingsschema.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="schema" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33260">a #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<record name="SettingsSchemaKey" c:type="GSettingsSchemaKey" glib:type-name="GSettingsSchemaKey" glib:get-type="g_settings_schema_key_get_type" c:symbol-prefix="settings_schema_key">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3004">#GSettingsSchemaKey is an opaque data structure and can only be accessed
|
|
using the following functions.</doc>
|
|
<source-position filename="gsettingsschema.h" line="28"/>
|
|
<method name="get_default_value" c:identifier="g_settings_schema_key_get_default_value" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32916">Gets the default value for @key.
|
|
|
|
Note that this is the default value according to the schema. System
|
|
administrator defaults and lockdown are not visible via this API.</doc>
|
|
<source-position filename="gsettingsschema.h" line="96"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32925">the default value for the key</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32918">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_description" c:identifier="g_settings_schema_key_get_description" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32930">Gets the description for @key.
|
|
|
|
If no description has been provided in the schema for @key, returns
|
|
%NULL.
|
|
|
|
The description can be one sentence to several paragraphs in length.
|
|
Paragraphs are delimited with a double newline. Descriptions can be
|
|
translated and the value returned from this function is is the
|
|
current locale.
|
|
|
|
This function is slow. The summary and description information for
|
|
the schemas is not stored in the compiled schema database so this
|
|
function has to parse all of the source XML files in the schema
|
|
directory.</doc>
|
|
<source-position filename="gsettingsschema.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32949">the description for @key, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32932">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_settings_schema_key_get_name" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32954">Gets the name of @key.</doc>
|
|
<source-position filename="gsettingsschema.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32960">the name of @key.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32956">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_range" c:identifier="g_settings_schema_key_get_range" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32965">Queries the range of a key.
|
|
|
|
This function will return a #GVariant that fully describes the range
|
|
of values that are valid for @key.
|
|
|
|
The type of #GVariant returned is `(sv)`. The string describes
|
|
the type of range restriction in effect. The type and meaning of
|
|
the value contained in the variant depends on the string.
|
|
|
|
If the string is `'type'` then the variant contains an empty array.
|
|
The element type of that empty array is the expected type of value
|
|
and all values of that type are valid.
|
|
|
|
If the string is `'enum'` then the variant contains an array
|
|
enumerating the possible values. Each item in the array is
|
|
a possible valid value and no other values are valid.
|
|
|
|
If the string is `'flags'` then the variant contains an array. Each
|
|
item in the array is a value that may appear zero or one times in an
|
|
array to be used as the value for this key. For example, if the
|
|
variant contained the array `['x', 'y']` then the valid values for
|
|
the key would be `[]`, `['x']`, `['y']`, `['x', 'y']` and
|
|
`['y', 'x']`.
|
|
|
|
Finally, if the string is `'range'` then the variant contains a pair
|
|
of like-typed values -- the minimum and maximum permissible values
|
|
for this key.
|
|
|
|
This information should not be used by normal programs. It is
|
|
considered to be a hint for introspection purposes. Normal programs
|
|
should already know what is permitted by their own schema. The
|
|
format may change in any way in the future -- but particularly, new
|
|
forms may be added to the possibilities described above.
|
|
|
|
You should free the returned value with g_variant_unref() when it is
|
|
no longer needed.</doc>
|
|
<source-position filename="gsettingsschema.h" line="98"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33006">a #GVariant describing the range</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="32967">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_summary" c:identifier="g_settings_schema_key_get_summary" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33011">Gets the summary for @key.
|
|
|
|
If no summary has been provided in the schema for @key, returns
|
|
%NULL.
|
|
|
|
The summary is a short description of the purpose of the key; usually
|
|
one short sentence. Summaries can be translated and the value
|
|
returned from this function is is the current locale.
|
|
|
|
This function is slow. The summary and description information for
|
|
the schemas is not stored in the compiled schema database so this
|
|
function has to parse all of the source XML files in the schema
|
|
directory.</doc>
|
|
<source-position filename="gsettingsschema.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33029">the summary for @key, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33013">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_value_type" c:identifier="g_settings_schema_key_get_value_type" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33034">Gets the #GVariantType of @key.</doc>
|
|
<source-position filename="gsettingsschema.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33040">the type of @key</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33036">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="range_check" c:identifier="g_settings_schema_key_range_check" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33045">Checks if the given @value is of the correct type and within the
|
|
permitted range for @key.
|
|
|
|
It is a programmer error if @value is not of the correct type -- you
|
|
must check for this first.</doc>
|
|
<source-position filename="gsettingsschema.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33056">%TRUE if @value is valid for @key</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33047">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33048">the value to check</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_settings_schema_key_ref" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33061">Increase the reference count of @key, returning a new reference.</doc>
|
|
<source-position filename="gsettingsschema.h" line="89"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33067">a new reference to @key</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33063">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_settings_schema_key_unref" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33072">Decrease the reference count of @key, possibly freeing it.</doc>
|
|
<source-position filename="gsettingsschema.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="key" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33074">a #GSettingsSchemaKey</doc>
|
|
<type name="SettingsSchemaKey" c:type="GSettingsSchemaKey*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<record name="SettingsSchemaSource" c:type="GSettingsSchemaSource" version="2.32" glib:type-name="GSettingsSchemaSource" glib:get-type="g_settings_schema_source_get_type" c:symbol-prefix="settings_schema_source">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3012">This is an opaque structure type. You may not access it directly.</doc>
|
|
<source-position filename="gsettingsschema.h" line="26"/>
|
|
<constructor name="new_from_directory" c:identifier="g_settings_schema_source_new_from_directory" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33194">Attempts to create a new schema source corresponding to the contents
|
|
of the given directory.
|
|
|
|
This function is not required for normal uses of #GSettings but it
|
|
may be useful to authors of plugin management systems.
|
|
|
|
The directory should contain a file called `gschemas.compiled` as
|
|
produced by the [glib-compile-schemas][glib-compile-schemas] tool.
|
|
|
|
If @trusted is %TRUE then `gschemas.compiled` is trusted not to be
|
|
corrupted. This assumption has a performance advantage, but can result
|
|
in crashes or inconsistent behaviour in the case of a corrupted file.
|
|
Generally, you should set @trusted to %TRUE for files installed by the
|
|
system and to %FALSE for files in the home directory.
|
|
|
|
In either case, an empty file or some types of corruption in the file will
|
|
result in %G_FILE_ERROR_INVAL being returned.
|
|
|
|
If @parent is non-%NULL then there are two effects.
|
|
|
|
First, if g_settings_schema_source_lookup() is called with the
|
|
@recursive flag set to %TRUE and the schema can not be found in the
|
|
source, the lookup will recurse to the parent.
|
|
|
|
Second, any references to other schemas specified within this
|
|
source (ie: `child` or `extends`) references may be resolved
|
|
from the @parent.
|
|
|
|
For this second reason, except in very unusual situations, the
|
|
@parent should probably be given as the default schema source, as
|
|
returned by g_settings_schema_source_get_default().</doc>
|
|
<source-position filename="gsettingsschema.h" line="42"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="directory" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33196">the filename of a directory</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parent" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33197">a #GSettingsSchemaSource, or %NULL</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</parameter>
|
|
<parameter name="trusted" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33198">%TRUE, if the directory is trusted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="list_schemas" c:identifier="g_settings_schema_source_list_schemas" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33146">Lists the schemas in a given source.
|
|
|
|
If @recursive is %TRUE then include parent sources. If %FALSE then
|
|
only include the schemas from one source (ie: one directory). You
|
|
probably want %TRUE.
|
|
|
|
Non-relocatable schemas are those for which you can call
|
|
g_settings_new(). Relocatable schemas are those for which you must
|
|
use g_settings_new_with_path().
|
|
|
|
Do not call this function from normal programs. This is designed for
|
|
use by database editors, commandline tools, etc.</doc>
|
|
<source-position filename="gsettingsschema.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33148">a #GSettingsSchemaSource</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</instance-parameter>
|
|
<parameter name="recursive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33149">if we should recurse</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="non_relocatable" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33150">the
|
|
list of non-relocatable schemas, in no defined order</doc>
|
|
<array c:type="gchar***">
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="relocatable" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33152">the list
|
|
of relocatable schemas, in no defined order</doc>
|
|
<array c:type="gchar***">
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup" c:identifier="g_settings_schema_source_lookup" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33172">Looks up a schema with the identifier @schema_id in @source.
|
|
|
|
This function is not required for normal uses of #GSettings but it
|
|
may be useful to authors of plugin management systems or to those who
|
|
want to introspect the content of schemas.
|
|
|
|
If the schema isn't found directly in @source and @recursive is %TRUE
|
|
then the parent sources will also be checked.
|
|
|
|
If the schema isn't found, %NULL is returned.</doc>
|
|
<source-position filename="gsettingsschema.h" line="48"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33189">a new #GSettingsSchema</doc>
|
|
<type name="SettingsSchema" c:type="GSettingsSchema*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33174">a #GSettingsSchemaSource</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</instance-parameter>
|
|
<parameter name="schema_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33175">a schema ID</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="recursive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33176">%TRUE if the lookup should be recursive</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ref" c:identifier="g_settings_schema_source_ref" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33237">Increase the reference count of @source, returning a new reference.</doc>
|
|
<source-position filename="gsettingsschema.h" line="37"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33243">a new reference to @source</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33239">a #GSettingsSchemaSource</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unref" c:identifier="g_settings_schema_source_unref" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33248">Decrease the reference count of @source, possibly freeing it.</doc>
|
|
<source-position filename="gsettingsschema.h" line="39"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33250">a #GSettingsSchemaSource</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="get_default" c:identifier="g_settings_schema_source_get_default" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33124">Gets the default system schema source.
|
|
|
|
This function is not required for normal uses of #GSettings but it
|
|
may be useful to authors of plugin management systems or to those who
|
|
want to introspect the content of schemas.
|
|
|
|
If no schemas are installed, %NULL will be returned.
|
|
|
|
The returned source may actually consist of multiple schema sources
|
|
from different directories, depending on which directories were given
|
|
in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all
|
|
lookups performed against the default source should probably be done
|
|
recursively.</doc>
|
|
<source-position filename="gsettingsschema.h" line="35"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33141">the default schema source</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</return-value>
|
|
</function>
|
|
</record>
|
|
<class name="SimpleAction" c:symbol-prefix="simple_action" c:type="GSimpleAction" parent="GObject.Object" glib:type-name="GSimpleAction" glib:get-type="g_simple_action_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8052">A #GSimpleAction is the obvious simple implementation of the #GAction
|
|
interface. This is the easiest way to create an action for purposes of
|
|
adding it to a #GSimpleActionGroup.
|
|
|
|
See also #GtkAction.</doc>
|
|
<implements name="Action"/>
|
|
<constructor name="new" c:identifier="g_simple_action_new" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33611">Creates a new action.
|
|
|
|
The created action is stateless. See g_simple_action_new_stateful() to create
|
|
an action that has state.</doc>
|
|
<source-position filename="gsimpleaction.h" line="41"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33622">a new #GSimpleAction</doc>
|
|
<type name="SimpleAction" c:type="GSimpleAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33613">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33614">the type of parameter that will be passed to
|
|
handlers for the #GSimpleAction::activate signal, or %NULL for no parameter</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_stateful" c:identifier="g_simple_action_new_stateful" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33627">Creates a new stateful action.
|
|
|
|
All future state values must have the same #GVariantType as the initial
|
|
@state.
|
|
|
|
If the @state #GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gsimpleaction.h" line="45"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33641">a new #GSimpleAction</doc>
|
|
<type name="SimpleAction" c:type="GSimpleAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33629">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="parameter_type" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33630">the type of the parameter that will be passed to
|
|
handlers for the #GSimpleAction::activate signal, or %NULL for no parameter</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
<parameter name="state" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33632">the initial state of the action</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="set_enabled" c:identifier="g_simple_action_set_enabled" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33646">Sets the action as enabled or not.
|
|
|
|
An action must be enabled in order to be activated or in order to
|
|
have its state changed from outside callers.
|
|
|
|
This should only be called by the implementor of the action. Users
|
|
of the action should not attempt to modify its enabled flag.</doc>
|
|
<source-position filename="gsimpleaction.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33648">a #GSimpleAction</doc>
|
|
<type name="SimpleAction" c:type="GSimpleAction*"/>
|
|
</instance-parameter>
|
|
<parameter name="enabled" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33649">whether the action is enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_state" c:identifier="g_simple_action_set_state" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33663">Sets the state of the action.
|
|
|
|
This directly updates the 'state' property to the given value.
|
|
|
|
This should only be called by the implementor of the action. Users
|
|
of the action should not attempt to directly modify the 'state'
|
|
property. Instead, they should call g_action_change_state() to
|
|
request the change.
|
|
|
|
If the @value GVariant is floating, it is consumed.</doc>
|
|
<source-position filename="gsimpleaction.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33665">a #GSimpleAction</doc>
|
|
<type name="SimpleAction" c:type="GSimpleAction*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33666">the new #GVariant for the state</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_state_hint" c:identifier="g_simple_action_set_state_hint" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33683">Sets the state hint for the action.
|
|
|
|
See g_action_get_state_hint() for more information about
|
|
action state hints.</doc>
|
|
<source-position filename="gsimpleaction.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33685">a #GSimpleAction</doc>
|
|
<type name="SimpleAction" c:type="GSimpleAction*"/>
|
|
</instance-parameter>
|
|
<parameter name="state_hint" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33686">a #GVariant representing the state hint</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="enabled" version="2.28" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3096">If @action is currently enabled.
|
|
|
|
If the action is disabled then calls to g_action_activate() and
|
|
g_action_change_state() have no effect.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="name" version="2.28" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3108">The name of the action. This is mostly meaningful for identifying
|
|
the action once it has been added to a #GSimpleActionGroup.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="parameter-type" version="2.28" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3118">The type of the parameter that must be given when activating the
|
|
action.</doc>
|
|
<type name="GLib.VariantType"/>
|
|
</property>
|
|
<property name="state" version="2.28" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3128">The state of the action, or %NULL if the action is stateless.</doc>
|
|
<type name="GLib.Variant"/>
|
|
</property>
|
|
<property name="state-type" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3137">The #GVariantType of the state that the action has, or %NULL if the
|
|
action is stateless.</doc>
|
|
<type name="GLib.VariantType"/>
|
|
</property>
|
|
<glib:signal name="activate" when="last" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3029">Indicates that the action was just activated.
|
|
|
|
@parameter will always be of the expected type, i.e. the parameter type
|
|
specified when the action was created. If an incorrect type is given when
|
|
activating the action, this signal is not emitted.
|
|
|
|
Since GLib 2.40, if no handler is connected to this signal then the
|
|
default behaviour for boolean-stated actions with a %NULL parameter
|
|
type is to toggle them via the #GSimpleAction::change-state signal.
|
|
For stateful actions where the state type is equal to the parameter
|
|
type, the default is to forward them directly to
|
|
#GSimpleAction::change-state. This should allow almost all users
|
|
of #GSimpleAction to connect only one handler or the other.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parameter" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3032">the parameter to the activation, or %NULL if it has
|
|
no parameter</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="change-state" when="last" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3053">Indicates that the action just received a request to change its
|
|
state.
|
|
|
|
@value will always be of the correct state type, i.e. the type of the
|
|
initial state passed to g_simple_action_new_stateful(). If an incorrect
|
|
type is given when requesting to change the state, this signal is not
|
|
emitted.
|
|
|
|
If no handler is connected to this signal then the default
|
|
behaviour is to call g_simple_action_set_state() to set the state
|
|
to the requested value. If you connect a signal handler then no
|
|
default action is taken. If the state should change then you must
|
|
call g_simple_action_set_state() from the handler.
|
|
|
|
An example of a 'change-state' handler:
|
|
|[<!-- language="C" -->
|
|
static void
|
|
change_volume_state (GSimpleAction *action,
|
|
GVariant *value,
|
|
gpointer user_data)
|
|
{
|
|
gint requested;
|
|
|
|
requested = g_variant_get_int32 (value);
|
|
|
|
// Volume only goes from 0 to 10
|
|
if (0 <= requested && requested <= 10)
|
|
g_simple_action_set_state (action, value);
|
|
}
|
|
]|
|
|
|
|
The handler need not set the state to the requested value.
|
|
It could set it to any value at all, or take some other action.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3056">the requested value for the state</doc>
|
|
<type name="GLib.Variant"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<class name="SimpleActionGroup" c:symbol-prefix="simple_action_group" c:type="GSimpleActionGroup" version="2.28" parent="GObject.Object" glib:type-name="GSimpleActionGroup" glib:get-type="g_simple_action_group_get_type" glib:type-struct="SimpleActionGroupClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8066">#GSimpleActionGroup is a hash table filled with #GAction objects,
|
|
implementing the #GActionGroup and #GActionMap interfaces.</doc>
|
|
<source-position filename="gsimpleactiongroup.h" line="69"/>
|
|
<implements name="ActionGroup"/>
|
|
<implements name="ActionMap"/>
|
|
<constructor name="new" c:identifier="g_simple_action_group_new" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33587">Creates a new, empty, #GSimpleActionGroup.</doc>
|
|
<source-position filename="gsimpleactiongroup.h" line="75"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33592">a new #GSimpleActionGroup</doc>
|
|
<type name="SimpleActionGroup" c:type="GSimpleActionGroup*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<method name="add_entries" c:identifier="g_simple_action_group_add_entries" version="2.30" deprecated="1" deprecated-version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33539">A convenience function for creating multiple #GSimpleAction instances
|
|
and adding them to the action group.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_action_map_add_action_entries()</doc-deprecated>
|
|
<source-position filename="gsimpleactiongroup.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33541">a #GSimpleActionGroup</doc>
|
|
<type name="SimpleActionGroup" c:type="GSimpleActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33542">a pointer to the first item in
|
|
an array of #GActionEntry structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="const GActionEntry*">
|
|
<type name="ActionEntry" c:type="GActionEntry"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33544">the length of @entries, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33545">the user data for signal connections</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="insert" c:identifier="g_simple_action_group_insert" version="2.28" deprecated="1" deprecated-version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33555">Adds an action to the action group.
|
|
|
|
If the action group already contains an action with the same name as
|
|
@action then the old action is dropped from the group.
|
|
|
|
The action group takes its own reference on @action.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_action_map_add_action()</doc-deprecated>
|
|
<source-position filename="gsimpleactiongroup.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33557">a #GSimpleActionGroup</doc>
|
|
<type name="SimpleActionGroup" c:type="GSimpleActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33558">a #GAction</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup" c:identifier="g_simple_action_group_lookup" version="2.28" deprecated="1" deprecated-version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33572">Looks up the action with the name @action_name in the group.
|
|
|
|
If no such action exists, returns %NULL.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_action_map_lookup_action()</doc-deprecated>
|
|
<source-position filename="gsimpleactiongroup.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33581">a #GAction, or %NULL</doc>
|
|
<type name="Action" c:type="GAction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33574">a #GSimpleActionGroup</doc>
|
|
<type name="SimpleActionGroup" c:type="GSimpleActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33575">the name of an action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="remove" c:identifier="g_simple_action_group_remove" version="2.28" deprecated="1" deprecated-version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33597">Removes the named action from the action group.
|
|
|
|
If no action of this name is in the group then nothing happens.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_action_map_remove_action()</doc-deprecated>
|
|
<source-position filename="gsimpleactiongroup.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33599">a #GSimpleActionGroup</doc>
|
|
<type name="SimpleActionGroup" c:type="GSimpleActionGroup*"/>
|
|
</instance-parameter>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33600">the name of the action</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="SimpleActionGroupPrivate" c:type="GSimpleActionGroupPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="SimpleActionGroupClass" c:type="GSimpleActionGroupClass" glib:is-gtype-struct-for="SimpleActionGroup">
|
|
<source-position filename="gsimpleactiongroup.h" line="69"/>
|
|
<field name="parent_class" readable="0" private="1">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="12">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="SimpleActionGroupPrivate" c:type="GSimpleActionGroupPrivate" disguised="1">
|
|
<source-position filename="gsimpleactiongroup.h" line="44"/>
|
|
</record>
|
|
<class name="SimpleAsyncResult" c:symbol-prefix="simple_async_result" c:type="GSimpleAsyncResult" parent="GObject.Object" glib:type-name="GSimpleAsyncResult" glib:get-type="g_simple_async_result_get_type" glib:type-struct="SimpleAsyncResultClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8077">As of GLib 2.46, #GSimpleAsyncResult is deprecated in favor of
|
|
#GTask, which provides a simpler API.
|
|
|
|
#GSimpleAsyncResult implements #GAsyncResult.
|
|
|
|
GSimpleAsyncResult handles #GAsyncReadyCallbacks, error
|
|
reporting, operation cancellation and the final state of an operation,
|
|
completely transparent to the application. Results can be returned
|
|
as a pointer e.g. for functions that return data that is collected
|
|
asynchronously, a boolean value for checking the success or failure
|
|
of an operation, or a #gssize for operations which return the number
|
|
of bytes modified by the operation; all of the simple return cases
|
|
are covered.
|
|
|
|
Most of the time, an application will not need to know of the details
|
|
of this API; it is handled transparently, and any necessary operations
|
|
are handled by #GAsyncResult's interface. However, if implementing a
|
|
new GIO module, for writing language bindings, or for complex
|
|
applications that need better control of how asynchronous operations
|
|
are completed, it is important to understand this functionality.
|
|
|
|
GSimpleAsyncResults are tagged with the calling function to ensure
|
|
that asynchronous functions and their finishing functions are used
|
|
together correctly.
|
|
|
|
To create a new #GSimpleAsyncResult, call g_simple_async_result_new().
|
|
If the result needs to be created for a #GError, use
|
|
g_simple_async_result_new_from_error() or
|
|
g_simple_async_result_new_take_error(). If a #GError is not available
|
|
(e.g. the asynchronous operation's doesn't take a #GError argument),
|
|
but the result still needs to be created for an error condition, use
|
|
g_simple_async_result_new_error() (or g_simple_async_result_set_error_va()
|
|
if your application or binding requires passing a variable argument list
|
|
directly), and the error can then be propagated through the use of
|
|
g_simple_async_result_propagate_error().
|
|
|
|
An asynchronous operation can be made to ignore a cancellation event by
|
|
calling g_simple_async_result_set_handle_cancellation() with a
|
|
#GSimpleAsyncResult for the operation and %FALSE. This is useful for
|
|
operations that are dangerous to cancel, such as close (which would
|
|
cause a leak if cancelled before being run).
|
|
|
|
GSimpleAsyncResult can integrate into GLib's event loop, #GMainLoop,
|
|
or it can use #GThreads.
|
|
g_simple_async_result_complete() will finish an I/O task directly
|
|
from the point where it is called. g_simple_async_result_complete_in_idle()
|
|
will finish it from an idle handler in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
where the #GSimpleAsyncResult was created.
|
|
g_simple_async_result_run_in_thread() will run the job in a
|
|
separate thread and then use
|
|
g_simple_async_result_complete_in_idle() to deliver the result.
|
|
|
|
To set the results of an asynchronous function,
|
|
g_simple_async_result_set_op_res_gpointer(),
|
|
g_simple_async_result_set_op_res_gboolean(), and
|
|
g_simple_async_result_set_op_res_gssize()
|
|
are provided, setting the operation's result to a gpointer, gboolean, or
|
|
gssize, respectively.
|
|
|
|
Likewise, to get the result of an asynchronous function,
|
|
g_simple_async_result_get_op_res_gpointer(),
|
|
g_simple_async_result_get_op_res_gboolean(), and
|
|
g_simple_async_result_get_op_res_gssize() are
|
|
provided, getting the operation's result as a gpointer, gboolean, and
|
|
gssize, respectively.
|
|
|
|
For the details of the requirements implementations must respect, see
|
|
#GAsyncResult. A typical implementation of an asynchronous operation
|
|
using GSimpleAsyncResult looks something like this:
|
|
|
|
|[<!-- language="C" -->
|
|
static void
|
|
baked_cb (Cake *cake,
|
|
gpointer user_data)
|
|
{
|
|
// In this example, this callback is not given a reference to the cake,
|
|
// so the GSimpleAsyncResult has to take a reference to it.
|
|
GSimpleAsyncResult *result = user_data;
|
|
|
|
if (cake == NULL)
|
|
g_simple_async_result_set_error (result,
|
|
BAKER_ERRORS,
|
|
BAKER_ERROR_NO_FLOUR,
|
|
"Go to the supermarket");
|
|
else
|
|
g_simple_async_result_set_op_res_gpointer (result,
|
|
g_object_ref (cake),
|
|
g_object_unref);
|
|
|
|
|
|
// In this example, we assume that baked_cb is called as a callback from
|
|
// the mainloop, so it's safe to complete the operation synchronously here.
|
|
// If, however, _baker_prepare_cake () might call its callback without
|
|
// first returning to the mainloop — inadvisable, but some APIs do so —
|
|
// we would need to use g_simple_async_result_complete_in_idle().
|
|
g_simple_async_result_complete (result);
|
|
g_object_unref (result);
|
|
}
|
|
|
|
void
|
|
baker_bake_cake_async (Baker *self,
|
|
guint radius,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
GSimpleAsyncResult *simple;
|
|
Cake *cake;
|
|
|
|
if (radius < 3)
|
|
{
|
|
g_simple_async_report_error_in_idle (G_OBJECT (self),
|
|
callback,
|
|
user_data,
|
|
BAKER_ERRORS,
|
|
BAKER_ERROR_TOO_SMALL,
|
|
"%ucm radius cakes are silly",
|
|
radius);
|
|
return;
|
|
}
|
|
|
|
simple = g_simple_async_result_new (G_OBJECT (self),
|
|
callback,
|
|
user_data,
|
|
baker_bake_cake_async);
|
|
cake = _baker_get_cached_cake (self, radius);
|
|
|
|
if (cake != NULL)
|
|
{
|
|
g_simple_async_result_set_op_res_gpointer (simple,
|
|
g_object_ref (cake),
|
|
g_object_unref);
|
|
g_simple_async_result_complete_in_idle (simple);
|
|
g_object_unref (simple);
|
|
// Drop the reference returned by _baker_get_cached_cake();
|
|
// the GSimpleAsyncResult has taken its own reference.
|
|
g_object_unref (cake);
|
|
return;
|
|
}
|
|
|
|
_baker_prepare_cake (self, radius, baked_cb, simple);
|
|
}
|
|
|
|
Cake *
|
|
baker_bake_cake_finish (Baker *self,
|
|
GAsyncResult *result,
|
|
GError **error)
|
|
{
|
|
GSimpleAsyncResult *simple;
|
|
Cake *cake;
|
|
|
|
g_return_val_if_fail (g_simple_async_result_is_valid (result,
|
|
G_OBJECT (self),
|
|
baker_bake_cake_async),
|
|
NULL);
|
|
|
|
simple = (GSimpleAsyncResult *) result;
|
|
|
|
if (g_simple_async_result_propagate_error (simple, error))
|
|
return NULL;
|
|
|
|
cake = CAKE (g_simple_async_result_get_op_res_gpointer (simple));
|
|
return g_object_ref (cake);
|
|
}
|
|
]|</doc>
|
|
<source-position filename="gsimpleasyncresult.h" line="44"/>
|
|
<implements name="AsyncResult"/>
|
|
<constructor name="new" c:identifier="g_simple_async_result_new" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33848">Creates a #GSimpleAsyncResult.
|
|
|
|
The common convention is to create the #GSimpleAsyncResult in the
|
|
function that starts the asynchronous operation and use that same
|
|
function as the @source_tag.
|
|
|
|
If your operation supports cancellation with #GCancellable (which it
|
|
probably should) then you should provide the user's cancellable to
|
|
g_simple_async_result_set_check_cancellable() immediately after
|
|
this function returns.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_task_new() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="51"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33866">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33850">a #GObject, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33851">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33852">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33853">the asynchronous function.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_error" c:identifier="g_simple_async_result_new_error" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33871">Creates a new #GSimpleAsyncResult with a set error.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_task_new() and g_task_return_new_error() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="56"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33883">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33873">a #GObject, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33874">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33875">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33876">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33877">an error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33878">a string with format characters.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33879">a list of values to insert into @format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_error" c:identifier="g_simple_async_result_new_from_error" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33888">Creates a #GSimpleAsyncResult from an error condition.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_task_new() and g_task_return_error() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="64"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33897">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33890">a #GObject, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33891">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33892">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33893">a #GError</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_take_error" c:identifier="g_simple_async_result_new_take_error" version="2.28" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33902">Creates a #GSimpleAsyncResult from an error condition, and takes over the
|
|
caller's ownership of @error, so the caller does not need to free it anymore.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_task_new() and g_task_return_error() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="69"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33912">a #GSimpleAsyncResult</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33904">a #GObject, or %NULL</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33905">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33906">user data passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33907">a #GError</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="is_valid" c:identifier="g_simple_async_result_is_valid" version="2.20" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33823">Ensures that the data passed to the _finish function of an async
|
|
operation is consistent. Three checks are performed.
|
|
|
|
First, @result is checked to ensure that it is really a
|
|
#GSimpleAsyncResult. Second, @source is checked to ensure that it
|
|
matches the source object of @result. Third, @source_tag is
|
|
checked to ensure that it is equal to the @source_tag argument given
|
|
to g_simple_async_result_new() (which, by convention, is a pointer
|
|
to the _async function corresponding to the _finish function from
|
|
which this function is called). (Alternatively, if either
|
|
@source_tag or @result's source tag is %NULL, then the source tag
|
|
check is skipped.)</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_is_valid() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="135"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33842">#TRUE if all checks passed or #FALSE if any failed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33825">the #GAsyncResult passed to the _finish function.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="source" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33826">the #GObject passed to the _finish function.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33827">the asynchronous function.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="complete" c:identifier="g_simple_async_result_complete" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33746">Completes an asynchronous I/O job immediately. Must be called in
|
|
the thread where the asynchronous result was to be delivered, as it
|
|
invokes the callback directly. If you are in a different thread use
|
|
g_simple_async_result_complete_in_idle().
|
|
|
|
Calling this function takes a reference to @simple for as long as
|
|
is needed to complete the call.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33748">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="complete_in_idle" c:identifier="g_simple_async_result_complete_in_idle" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33762">Completes an asynchronous function in an idle handler in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread that @simple was initially created in
|
|
(and re-pushes that context around the invocation of the callback).
|
|
|
|
Calling this function takes a reference to @simple for as long as
|
|
is needed to complete the call.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33764">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_op_res_gboolean" c:identifier="g_simple_async_result_get_op_res_gboolean" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33778">Gets the operation result boolean from within the asynchronous result.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_propagate_boolean() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33784">%TRUE if the operation's result was %TRUE, %FALSE
|
|
if the operation's result was %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33780">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_op_res_gpointer" c:identifier="g_simple_async_result_get_op_res_gpointer" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33790">Gets a pointer result as returned by the asynchronous function.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_propagate_pointer() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="79"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33796">a pointer from the result.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33792">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_op_res_gssize" c:identifier="g_simple_async_result_get_op_res_gssize" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33801">Gets a gssize from the asynchronous result.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_propagate_int() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33807">a gssize returned from the asynchronous function.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33803">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_source_tag" c:identifier="g_simple_async_result_get_source_tag" introspectable="0" deprecated="1" deprecated-version="2.46.">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33812">Gets the source tag for the #GSimpleAsyncResult.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_get_source_tag() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="99"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33818">a #gpointer to the source object for the #GSimpleAsyncResult.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33814">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="propagate_error" c:identifier="g_simple_async_result_propagate_error" deprecated="1" deprecated-version="2.46" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33918">Propagates an error from within the simple asynchronous result to
|
|
a given destination.
|
|
|
|
If the #GCancellable given to a prior call to
|
|
g_simple_async_result_set_check_cancellable() is cancelled then this
|
|
function will return %TRUE with @dest set appropriately.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33930">%TRUE if the error was propagated to @dest. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33920">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="run_in_thread" c:identifier="g_simple_async_result_run_in_thread" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33935">Runs the asynchronous job in a separate thread and then calls
|
|
g_simple_async_result_complete_in_idle() on @simple to return
|
|
the result to the appropriate main loop.
|
|
|
|
Calling this function takes a reference to @simple for as long as
|
|
is needed to run the job and report its completion.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_run_in_thread() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33937">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="func" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33938">a #GSimpleAsyncThreadFunc.</doc>
|
|
<type name="SimpleAsyncThreadFunc" c:type="GSimpleAsyncThreadFunc"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33939">the io priority of the request.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33940">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_check_cancellable" c:identifier="g_simple_async_result_set_check_cancellable" version="2.32" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33953">Sets a #GCancellable to check before dispatching results.
|
|
|
|
This function has one very specific purpose: the provided cancellable
|
|
is checked at the time of g_simple_async_result_propagate_error() If
|
|
it is cancelled, these functions will return an "Operation was
|
|
cancelled" error (%G_IO_ERROR_CANCELLED).
|
|
|
|
Implementors of cancellable asynchronous functions should use this in
|
|
order to provide a guarantee to their callers that cancelling an
|
|
async operation will reliably result in an error being returned for
|
|
that operation (even if a positive result for the operation has
|
|
already been sent as an idle to the main context to be dispatched).
|
|
|
|
The checking described above is done regardless of any call to the
|
|
unrelated g_simple_async_result_set_handle_cancellation() function.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33955">a #GSimpleAsyncResult</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="check_cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33956">a #GCancellable to check, or %NULL to unset</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_error" c:identifier="g_simple_async_result_set_error" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33979">Sets an error within the asynchronous result without a #GError.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_return_new_error() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33981">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33982">a #GQuark (usually #G_IO_ERROR).</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33983">an error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33984">a formatted error reporting string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33985">a list of variables to fill in @format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_error_va" c:identifier="g_simple_async_result_set_error_va" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33993">Sets an error within the asynchronous result without a #GError.
|
|
Unless writing a binding, see g_simple_async_result_set_error().</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_return_error() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33995">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33996">a #GQuark (usually #G_IO_ERROR).</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33997">an error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33998">a formatted error reporting string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="args" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33999">va_list of arguments.</doc>
|
|
<type name="va_list" c:type="va_list"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_from_error" c:identifier="g_simple_async_result_set_from_error" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34008">Sets the result from a #GError.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_return_error() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34010">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34011">#GError.</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_handle_cancellation" c:identifier="g_simple_async_result_set_handle_cancellation" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34019">Sets whether to handle cancellation within the asynchronous operation.
|
|
|
|
This function has nothing to do with
|
|
g_simple_async_result_set_check_cancellable(). It only refers to the
|
|
#GCancellable passed to g_simple_async_result_run_in_thread().</doc>
|
|
<source-position filename="gsimpleasyncresult.h" line="101"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34021">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="handle_cancellation" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34022">a #gboolean.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_op_res_gboolean" c:identifier="g_simple_async_result_set_op_res_gboolean" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34034">Sets the operation result to a boolean within the asynchronous result.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_return_boolean() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34036">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="op_res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34037">a #gboolean.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_op_res_gpointer" c:identifier="g_simple_async_result_set_op_res_gpointer" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34045">Sets the operation result within the asynchronous result to a pointer.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_return_pointer() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34047">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="op_res" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34048">a pointer result from an asynchronous function.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="destroy_op_res" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34049">a #GDestroyNotify function.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_op_res_gssize" c:identifier="g_simple_async_result_set_op_res_gssize" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34057">Sets the operation result within the asynchronous result to
|
|
the given @op_res.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_return_int() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34059">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="op_res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34060">a #gssize.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_error" c:identifier="g_simple_async_result_take_error" version="2.28" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34069">Sets the result from @error, and takes over the caller's ownership
|
|
of @error, so the caller does not need to free it any more.</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GTask and g_task_return_error() instead.</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="simple" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34071">a #GSimpleAsyncResult</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</instance-parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34072">a #GError</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
</class>
|
|
<record name="SimpleAsyncResultClass" c:type="GSimpleAsyncResultClass" disguised="1" glib:is-gtype-struct-for="SimpleAsyncResult">
|
|
<source-position filename="gsimpleasyncresult.h" line="44"/>
|
|
</record>
|
|
<callback name="SimpleAsyncThreadFunc" c:type="GSimpleAsyncThreadFunc">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="372">Simple thread function that runs an asynchronous operation and
|
|
checks for cancellation.</doc>
|
|
<source-position filename="giotypes.h" line="381"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="374">a #GSimpleAsyncResult.</doc>
|
|
<type name="SimpleAsyncResult" c:type="GSimpleAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="375">a #GObject.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="376">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="SimpleIOStream" c:symbol-prefix="simple_io_stream" c:type="GSimpleIOStream" version="2.44" parent="IOStream" glib:type-name="GSimpleIOStream" glib:get-type="g_simple_io_stream_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8251">GSimpleIOStream creates a #GIOStream from an arbitrary #GInputStream and
|
|
#GOutputStream. This allows any pair of input and output streams to be used
|
|
with #GIOStream methods.
|
|
|
|
This is useful when you obtained a #GInputStream and a #GOutputStream
|
|
by other means, for instance creating them with platform specific methods as
|
|
g_unix_input_stream_new() or g_win32_input_stream_new(), and you want
|
|
to take advantage of the methods provided by #GIOStream.</doc>
|
|
<constructor name="new" c:identifier="g_simple_io_stream_new" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34082">Creates a new #GSimpleIOStream wrapping @input_stream and @output_stream.
|
|
See also #GIOStream.</doc>
|
|
<source-position filename="gsimpleiostream.h" line="40"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34090">a new #GSimpleIOStream instance.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="input_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34084">a #GInputStream.</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="output_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34085">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<property name="input-stream" version="2.44" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="InputStream"/>
|
|
</property>
|
|
<property name="output-stream" version="2.44" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="OutputStream"/>
|
|
</property>
|
|
</class>
|
|
<class name="SimplePermission" c:symbol-prefix="simple_permission" c:type="GSimplePermission" parent="Permission" glib:type-name="GSimplePermission" glib:get-type="g_simple_permission_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8270">#GSimplePermission is a trivial implementation of #GPermission that
|
|
represents a permission that is either always or never allowed. The
|
|
value is given at construction and doesn't change.
|
|
|
|
Calling request or release will result in errors.</doc>
|
|
<constructor name="new" c:identifier="g_simple_permission_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34095">Creates a new #GPermission instance that represents an action that is
|
|
either always or never allowed.</doc>
|
|
<source-position filename="gsimplepermission.h" line="41"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34102">the #GSimplePermission, as a #GPermission</doc>
|
|
<type name="Permission" c:type="GPermission*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="allowed" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34097">%TRUE if the action is allowed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
</class>
|
|
<class name="SimpleProxyResolver" c:symbol-prefix="simple_proxy_resolver" c:type="GSimpleProxyResolver" version="2.36" parent="GObject.Object" glib:type-name="GSimpleProxyResolver" glib:get-type="g_simple_proxy_resolver_get_type" glib:type-struct="SimpleProxyResolverClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8284">#GSimpleProxyResolver is a simple #GProxyResolver implementation
|
|
that handles a single default proxy, multiple URI-scheme-specific
|
|
proxies, and a list of hosts that proxies should not be used for.
|
|
|
|
#GSimpleProxyResolver is never the default proxy resolver, but it
|
|
can be used as the base class for another proxy resolver
|
|
implementation, or it can be created and used manually, such as
|
|
with g_socket_client_set_proxy_resolver().</doc>
|
|
<source-position filename="gsimpleproxyresolver.h" line="65"/>
|
|
<implements name="ProxyResolver"/>
|
|
<function name="new" c:identifier="g_simple_proxy_resolver_new" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34107">Creates a new #GSimpleProxyResolver. See
|
|
#GSimpleProxyResolver:default-proxy and
|
|
#GSimpleProxyResolver:ignore-hosts for more details on how the
|
|
arguments are interpreted.</doc>
|
|
<source-position filename="gsimpleproxyresolver.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34119">a new #GSimpleProxyResolver</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="default_proxy" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34109">the default proxy to use, eg
|
|
"socks://192.168.1.1"</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="ignore_hosts" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34111">an optional list of hosts/IP addresses
|
|
to not use a proxy for.</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="set_default_proxy" c:identifier="g_simple_proxy_resolver_set_default_proxy" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34124">Sets the default proxy on @resolver, to be used for any URIs that
|
|
don't match #GSimpleProxyResolver:ignore-hosts or a proxy set
|
|
via g_simple_proxy_resolver_set_uri_proxy().
|
|
|
|
If @default_proxy starts with "socks://",
|
|
#GSimpleProxyResolver will treat it as referring to all three of
|
|
the socks5, socks4a, and socks4 proxy types.</doc>
|
|
<source-position filename="gsimpleproxyresolver.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34126">a #GSimpleProxyResolver</doc>
|
|
<type name="SimpleProxyResolver" c:type="GSimpleProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="default_proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34127">the default proxy to use</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_ignore_hosts" c:identifier="g_simple_proxy_resolver_set_ignore_hosts" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34141">Sets the list of ignored hosts.
|
|
|
|
See #GSimpleProxyResolver:ignore-hosts for more details on how the
|
|
@ignore_hosts argument is interpreted.</doc>
|
|
<source-position filename="gsimpleproxyresolver.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34143">a #GSimpleProxyResolver</doc>
|
|
<type name="SimpleProxyResolver" c:type="GSimpleProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="ignore_hosts" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34144">%NULL-terminated list of hosts/IP addresses
|
|
to not use a proxy for</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_uri_proxy" c:identifier="g_simple_proxy_resolver_set_uri_proxy" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34156">Adds a URI-scheme-specific proxy to @resolver; URIs whose scheme
|
|
matches @uri_scheme (and which don't match
|
|
#GSimpleProxyResolver:ignore-hosts) will be proxied via @proxy.
|
|
|
|
As with #GSimpleProxyResolver:default-proxy, if @proxy starts with
|
|
"socks://", #GSimpleProxyResolver will treat it
|
|
as referring to all three of the socks5, socks4a, and socks4 proxy
|
|
types.</doc>
|
|
<source-position filename="gsimpleproxyresolver.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="resolver" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34158">a #GSimpleProxyResolver</doc>
|
|
<type name="SimpleProxyResolver" c:type="GSimpleProxyResolver*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34159">the URI scheme to add a proxy for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="proxy" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34160">the proxy to use for @uri_scheme</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="default-proxy" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3178">The default proxy URI that will be used for any URI that doesn't
|
|
match #GSimpleProxyResolver:ignore-hosts, and doesn't match any
|
|
of the schemes set with g_simple_proxy_resolver_set_uri_proxy().
|
|
|
|
Note that as a special case, if this URI starts with
|
|
"socks://", #GSimpleProxyResolver will treat it as referring
|
|
to all three of the socks5, socks4a, and socks4 proxy types.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="ignore-hosts" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3191">A list of hostnames and IP addresses that the resolver should
|
|
allow direct connections to.
|
|
|
|
Entries can be in one of 4 formats:
|
|
|
|
- A hostname, such as "example.com", ".example.com", or
|
|
"*.example.com", any of which match "example.com" or
|
|
any subdomain of it.
|
|
|
|
- An IPv4 or IPv6 address, such as "192.168.1.1",
|
|
which matches only that address.
|
|
|
|
- A hostname or IP address followed by a port, such as
|
|
"example.com:80", which matches whatever the hostname or IP
|
|
address would match, but only for URLs with the (explicitly)
|
|
indicated port. In the case of an IPv6 address, the address
|
|
part must appear in brackets: "[::1]:443"
|
|
|
|
- An IP address range, given by a base address and prefix length,
|
|
such as "fe80::/10", which matches any address in that range.
|
|
|
|
Note that when dealing with Unicode hostnames, the matching is
|
|
done against the ASCII form of the name.
|
|
|
|
Also note that hostname exclusions apply only to connections made
|
|
to hosts identified by name, and IP address exclusions apply only
|
|
to connections made to hosts identified by address. That is, if
|
|
example.com has an address of 192.168.1.1, and the :ignore-hosts list
|
|
contains only "192.168.1.1", then a connection to "example.com"
|
|
(eg, via a #GNetworkAddress) will use the proxy, and a connection to
|
|
"192.168.1.1" (eg, via a #GInetSocketAddress) will not.
|
|
|
|
These rules match the "ignore-hosts"/"noproxy" rules most
|
|
commonly used by other applications.</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="SimpleProxyResolverPrivate" c:type="GSimpleProxyResolverPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="SimpleProxyResolverClass" c:type="GSimpleProxyResolverClass" glib:is-gtype-struct-for="SimpleProxyResolver">
|
|
<source-position filename="gsimpleproxyresolver.h" line="65"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gsimpleproxyresolver.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gsimpleproxyresolver.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gsimpleproxyresolver.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gsimpleproxyresolver.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gsimpleproxyresolver.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="SimpleProxyResolverPrivate" c:type="GSimpleProxyResolverPrivate" disguised="1">
|
|
<source-position filename="gsimpleproxyresolver.h" line="43"/>
|
|
</record>
|
|
<class name="Socket" c:symbol-prefix="socket" c:type="GSocket" version="2.22" parent="GObject.Object" glib:type-name="GSocket" glib:get-type="g_socket_get_type" glib:type-struct="SocketClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8303">A #GSocket is a low-level networking primitive. It is a more or less
|
|
direct mapping of the BSD socket API in a portable GObject based API.
|
|
It supports both the UNIX socket implementations and winsock2 on Windows.
|
|
|
|
#GSocket is the platform independent base upon which the higher level
|
|
network primitives are based. Applications are not typically meant to
|
|
use it directly, but rather through classes like #GSocketClient,
|
|
#GSocketService and #GSocketConnection. However there may be cases where
|
|
direct use of #GSocket is useful.
|
|
|
|
#GSocket implements the #GInitable interface, so if it is manually constructed
|
|
by e.g. g_object_new() you must call g_initable_init() and check the
|
|
results before using the object. This is done automatically in
|
|
g_socket_new() and g_socket_new_from_fd(), so these functions can return
|
|
%NULL.
|
|
|
|
Sockets operate in two general modes, blocking or non-blocking. When
|
|
in blocking mode all operations (which don’t take an explicit blocking
|
|
parameter) block until the requested operation
|
|
is finished or there is an error. In non-blocking mode all calls that
|
|
would block return immediately with a %G_IO_ERROR_WOULD_BLOCK error.
|
|
To know when a call would successfully run you can call g_socket_condition_check(),
|
|
or g_socket_condition_wait(). You can also use g_socket_create_source() and
|
|
attach it to a #GMainContext to get callbacks when I/O is possible.
|
|
Note that all sockets are always set to non blocking mode in the system, and
|
|
blocking mode is emulated in GSocket.
|
|
|
|
When working in non-blocking mode applications should always be able to
|
|
handle getting a %G_IO_ERROR_WOULD_BLOCK error even when some other
|
|
function said that I/O was possible. This can easily happen in case
|
|
of a race condition in the application, but it can also happen for other
|
|
reasons. For instance, on Windows a socket is always seen as writable
|
|
until a write returns %G_IO_ERROR_WOULD_BLOCK.
|
|
|
|
#GSockets can be either connection oriented or datagram based.
|
|
For connection oriented types you must first establish a connection by
|
|
either connecting to an address or accepting a connection from another
|
|
address. For connectionless socket types the target/source address is
|
|
specified or received in each I/O operation.
|
|
|
|
All socket file descriptors are set to be close-on-exec.
|
|
|
|
Note that creating a #GSocket causes the signal %SIGPIPE to be
|
|
ignored for the remainder of the program. If you are writing a
|
|
command-line utility that uses #GSocket, you may need to take into
|
|
account the fact that your program will not automatically be killed
|
|
if it tries to write to %stdout after it has been closed.
|
|
|
|
Like most other APIs in GLib, #GSocket is not inherently thread safe. To use
|
|
a #GSocket concurrently from multiple threads, you must implement your own
|
|
locking.</doc>
|
|
<source-position filename="gsocket.h" line="66"/>
|
|
<implements name="DatagramBased"/>
|
|
<implements name="Initable"/>
|
|
<constructor name="new" c:identifier="g_socket_new" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36061">Creates a new #GSocket with the defined family, type and protocol.
|
|
If @protocol is 0 (%G_SOCKET_PROTOCOL_DEFAULT) the default protocol type
|
|
for the family and type is used.
|
|
|
|
The @protocol is a family and type specific int that specifies what
|
|
kind of protocol to use. #GSocketProtocol lists several common ones.
|
|
Many families only support one protocol, and use 0 for this, others
|
|
support several and using 0 means to use the default protocol for
|
|
the family and type.
|
|
|
|
The protocol id is passed directly to the operating
|
|
system, so you can use protocols not listed in #GSocketProtocol if you
|
|
know the protocol number used for it.</doc>
|
|
<source-position filename="gsocket.h" line="77"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36082">a #GSocket or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="family" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36063">the socket family to use, e.g. %G_SOCKET_FAMILY_IPV4.</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36064">the socket type to use.</doc>
|
|
<type name="SocketType" c:type="GSocketType"/>
|
|
</parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36065">the id of the protocol to use, or 0 for default.</doc>
|
|
<type name="SocketProtocol" c:type="GSocketProtocol"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_fd" c:identifier="g_socket_new_from_fd" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36088">Creates a new #GSocket from a native file descriptor
|
|
or winsock SOCKET handle.
|
|
|
|
This reads all the settings from the file descriptor so that
|
|
all properties should work. Note that the file descriptor
|
|
will be set to non-blocking mode, independent on the blocking
|
|
mode of the #GSocket.
|
|
|
|
On success, the returned #GSocket takes ownership of @fd. On failure, the
|
|
caller must close @fd themselves.
|
|
|
|
Since GLib 2.46, it is no longer a fatal error to call this on a non-socket
|
|
descriptor. Instead, a GError will be set with code %G_IO_ERROR_FAILED</doc>
|
|
<source-position filename="gsocket.h" line="82"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36107">a #GSocket or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36090">a native socket file descriptor.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="accept" c:identifier="g_socket_accept" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34175">Accept incoming connections on a connection-based socket. This removes
|
|
the first outstanding connection request from the listening socket and
|
|
creates a #GSocket object for it.
|
|
|
|
The @socket must be bound to a local address with g_socket_bind() and
|
|
must be listening for incoming connections (g_socket_listen()).
|
|
|
|
If there are no outstanding connections then the operation will block
|
|
or return %G_IO_ERROR_WOULD_BLOCK if non-blocking I/O is enabled.
|
|
To be notified of an incoming connection, wait for the %G_IO_IN condition.</doc>
|
|
<source-position filename="gsocket.h" line="199"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34192">a new #GSocket, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34177">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34178">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="bind" c:identifier="g_socket_bind" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34317">When a socket is created it is attached to an address family, but it
|
|
doesn't have an address in this family. g_socket_bind() assigns the
|
|
address (sometimes called name) of the socket.
|
|
|
|
It is generally required to bind to a local address before you can
|
|
receive connections. (See g_socket_listen() and g_socket_accept() ).
|
|
In certain situations, you may also want to bind a socket that will be
|
|
used to initiate connections, though this is not normally required.
|
|
|
|
If @socket is a TCP socket, then @allow_reuse controls the setting
|
|
of the `SO_REUSEADDR` socket option; normally it should be %TRUE for
|
|
server sockets (sockets that you will eventually call
|
|
g_socket_accept() on), and %FALSE for client sockets. (Failing to
|
|
set this flag on a server socket may cause g_socket_bind() to return
|
|
%G_IO_ERROR_ADDRESS_IN_USE if the server program is stopped and then
|
|
immediately restarted.)
|
|
|
|
If @socket is a UDP socket, then @allow_reuse determines whether or
|
|
not other UDP sockets can be bound to the same address at the same
|
|
time. In particular, you can have several UDP sockets bound to the
|
|
same address, and they will all receive all of the multicast and
|
|
broadcast packets sent to that address. (The behavior of unicast
|
|
UDP packets to an address with multiple listeners is not defined.)</doc>
|
|
<source-position filename="gsocket.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34348">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34319">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34320">a #GSocketAddress specifying the local address.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="allow_reuse" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34321">whether to allow reusing this address</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="check_connect_result" c:identifier="g_socket_check_connect_result" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34353">Checks and resets the pending connect error for the socket.
|
|
This is used to check for errors when g_socket_connect() is
|
|
used in non-blocking mode.</doc>
|
|
<source-position filename="gsocket.h" line="178"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34362">%TRUE if no error, %FALSE otherwise, setting @error to the error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34355">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close" c:identifier="g_socket_close" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34941">Closes the socket, shutting down any active connection.
|
|
|
|
Closing a socket does not wait for all outstanding I/O operations
|
|
to finish, so the caller should not rely on them to be guaranteed
|
|
to complete even if the close returns with no error.
|
|
|
|
Once the socket is closed, all other operations will return
|
|
%G_IO_ERROR_CLOSED. Closing a socket multiple times will not
|
|
return an error.
|
|
|
|
Sockets will be automatically closed when the last reference
|
|
is dropped, but you might want to call this function to make sure
|
|
resources are released as early as possible.
|
|
|
|
Beware that due to the way that TCP works, it is possible for
|
|
recently-sent data to be lost if either you close a socket while the
|
|
%G_IO_IN condition is set, or else if the remote connection tries to
|
|
send something to you after you close the socket but before it has
|
|
finished reading all of the data you sent. There is no easy generic
|
|
way to avoid this problem; the easiest fix is to design the network
|
|
protocol such that the client will never send data "out of turn".
|
|
Another solution is for the server to half-close the connection by
|
|
calling g_socket_shutdown() with only the @shutdown_write flag set,
|
|
and then wait for the client to notice this and close its side of the
|
|
connection, after which the server can safely call g_socket_close().
|
|
(This is what #GTcpConnection does if you call
|
|
g_tcp_connection_set_graceful_disconnect(). But of course, this
|
|
only works if the client will close its connection after the server
|
|
does.)</doc>
|
|
<source-position filename="gsocket.h" line="268"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34976">%TRUE on success, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34943">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="condition_check" c:identifier="g_socket_condition_check" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34981">Checks on the readiness of @socket to perform operations.
|
|
The operations specified in @condition are checked for and masked
|
|
against the currently-satisfied conditions on @socket. The result
|
|
is returned.
|
|
|
|
Note that on Windows, it is possible for an operation to return
|
|
%G_IO_ERROR_WOULD_BLOCK even immediately after
|
|
g_socket_condition_check() has claimed that the socket is ready for
|
|
writing. Rather than calling g_socket_condition_check() and then
|
|
writing to the socket if it succeeds, it is generally better to
|
|
simply try writing to the socket right away, and try again later if
|
|
the initial attempt returns %G_IO_ERROR_WOULD_BLOCK.
|
|
|
|
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in condition;
|
|
these conditions will always be set in the output if they are true.
|
|
|
|
This call never blocks.</doc>
|
|
<source-position filename="gsocket.h" line="185"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35004">the @GIOCondition mask of the current state</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34983">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34984">a #GIOCondition mask to check</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="condition_timed_wait" c:identifier="g_socket_condition_timed_wait" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35009">Waits for up to @timeout_us microseconds for @condition to become true
|
|
on @socket. If the condition is met, %TRUE is returned.
|
|
|
|
If @cancellable is cancelled before the condition is met, or if
|
|
@timeout_us (or the socket's #GSocket:timeout) is reached before the
|
|
condition is met, then %FALSE is returned and @error, if non-%NULL,
|
|
is set to the appropriate value (%G_IO_ERROR_CANCELLED or
|
|
%G_IO_ERROR_TIMED_OUT).
|
|
|
|
If you don't want a timeout, use g_socket_condition_wait().
|
|
(Alternatively, you can pass -1 for @timeout_us.)
|
|
|
|
Note that although @timeout_us is in microseconds for consistency with
|
|
other GLib APIs, this function actually only has millisecond
|
|
resolution, and the behavior is undefined if @timeout_us is not an
|
|
exact number of milliseconds.</doc>
|
|
<source-position filename="gsocket.h" line="193"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35034">%TRUE if the condition was met, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35011">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35012">a #GIOCondition mask to wait for</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="timeout_us" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35013">the maximum time (in microseconds) to wait, or -1</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35014">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="condition_wait" c:identifier="g_socket_condition_wait" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35039">Waits for @condition to become true on @socket. When the condition
|
|
is met, %TRUE is returned.
|
|
|
|
If @cancellable is cancelled before the condition is met, or if the
|
|
socket has a timeout set and it is reached before the condition is
|
|
met, then %FALSE is returned and @error, if non-%NULL, is set to
|
|
the appropriate value (%G_IO_ERROR_CANCELLED or
|
|
%G_IO_ERROR_TIMED_OUT).
|
|
|
|
See also g_socket_condition_timed_wait().</doc>
|
|
<source-position filename="gsocket.h" line="188"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35057">%TRUE if the condition was met, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35041">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35042">a #GIOCondition mask to wait for</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35043">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect" c:identifier="g_socket_connect" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35062">Connect the socket to the specified remote address.
|
|
|
|
For connection oriented socket this generally means we attempt to make
|
|
a connection to the @address. For a connection-less socket it sets
|
|
the default address for g_socket_send() and discards all incoming datagrams
|
|
from other sources.
|
|
|
|
Generally connection oriented sockets can only connect once, but
|
|
connection-less sockets can connect multiple times to change the
|
|
default address.
|
|
|
|
If the connect call needs to do network I/O it will block, unless
|
|
non-blocking I/O is enabled. Then %G_IO_ERROR_PENDING is returned
|
|
and the user can be notified of the connection finishing by waiting
|
|
for the G_IO_OUT condition. The result of the connection must then be
|
|
checked with g_socket_check_connect_result().</doc>
|
|
<source-position filename="gsocket.h" line="173"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35086">%TRUE if connected, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35064">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35065">a #GSocketAddress specifying the remote address.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35066">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connection_factory_create_connection" c:identifier="g_socket_connection_factory_create_connection" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35182">Creates a #GSocketConnection subclass of the right type for
|
|
@socket.</doc>
|
|
<source-position filename="gsocketconnection.h" line="111"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35189">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35184">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="create_source" c:identifier="g_socket_create_source" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35356">Creates a #GSource that can be attached to a %GMainContext to monitor
|
|
for the availability of the specified @condition on the socket. The #GSource
|
|
keeps a reference to the @socket.
|
|
|
|
The callback on the source is of the #GSocketSourceFunc type.
|
|
|
|
It is meaningless to specify %G_IO_ERR or %G_IO_HUP in @condition;
|
|
these conditions will always be reported output if they are true.
|
|
|
|
@cancellable if not %NULL can be used to cancel the source, which will
|
|
cause the source to trigger, reporting the current condition (which
|
|
is likely 0 unless cancellation happened at the same time as a
|
|
condition change). You can check for this in the callback using
|
|
g_cancellable_is_cancelled().
|
|
|
|
If @socket has a timeout set, and it is reached before @condition
|
|
occurs, the source will then trigger anyway, reporting %G_IO_IN or
|
|
%G_IO_OUT depending on @condition. However, @socket will have been
|
|
marked as having had a timeout, and so the next #GSocket I/O method
|
|
you call will then fail with a %G_IO_ERROR_TIMED_OUT.</doc>
|
|
<source-position filename="gsocket.h" line="278"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35383">a newly allocated %GSource, free with g_source_unref().</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35358">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35359">a #GIOCondition mask to monitor</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35360">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_available_bytes" c:identifier="g_socket_get_available_bytes" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35388">Get the amount of data pending in the OS input buffer, without blocking.
|
|
|
|
If @socket is a UDP or SCTP socket, this will return the size of
|
|
just the next packet, even if additional packets are buffered after
|
|
that one.
|
|
|
|
Note that on Windows, this function is rather inefficient in the
|
|
UDP case, and so if you know any plausible upper bound on the size
|
|
of the incoming packet, it is better to just do a
|
|
g_socket_receive() with a buffer of that size, rather than calling
|
|
g_socket_get_available_bytes() first and then doing a receive of
|
|
exactly the right size.</doc>
|
|
<source-position filename="gsocket.h" line="182"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35405">the number of bytes that can be read from the socket
|
|
without blocking or truncating, or -1 on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35390">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_blocking" c:identifier="g_socket_get_blocking" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35411">Gets the blocking mode of the socket. For details on blocking I/O,
|
|
see g_socket_set_blocking().</doc>
|
|
<source-position filename="gsocket.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35418">%TRUE if blocking I/O is used, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35413">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_broadcast" c:identifier="g_socket_get_broadcast" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35423">Gets the broadcast setting on @socket; if %TRUE,
|
|
it is possible to send packets to broadcast
|
|
addresses.</doc>
|
|
<source-position filename="gsocket.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35431">the broadcast setting on @socket</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35425">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_credentials" c:identifier="g_socket_get_credentials" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35436">Returns the credentials of the foreign process connected to this
|
|
socket, if any (e.g. it is only supported for %G_SOCKET_FAMILY_UNIX
|
|
sockets).
|
|
|
|
If this operation isn't supported on the OS, the method fails with
|
|
the %G_IO_ERROR_NOT_SUPPORTED error. On Linux this is implemented
|
|
by reading the %SO_PEERCRED option on the underlying socket.
|
|
|
|
This method can be expected to be available on the following platforms:
|
|
|
|
- Linux since GLib 2.26
|
|
- OpenBSD since GLib 2.30
|
|
- Solaris, Illumos and OpenSolaris since GLib 2.40
|
|
- NetBSD since GLib 2.42
|
|
|
|
Other ways to obtain credentials from a foreign peer includes the
|
|
#GUnixCredentialsMessage type and
|
|
g_unix_connection_send_credentials() /
|
|
g_unix_connection_receive_credentials() functions.</doc>
|
|
<source-position filename="gsocket.h" line="284"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35461">%NULL if @error is set, otherwise a #GCredentials object
|
|
that must be freed with g_object_unref().</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35438">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_family" c:identifier="g_socket_get_family" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35467">Gets the socket family of the socket.</doc>
|
|
<source-position filename="gsocket.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35473">a #GSocketFamily</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35469">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_fd" c:identifier="g_socket_get_fd" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35478">Returns the underlying OS socket object. On unix this
|
|
is a socket file descriptor, and on Windows this is
|
|
a Winsock2 SOCKET handle. This may be useful for
|
|
doing platform specific or otherwise unusual operations
|
|
on the socket.</doc>
|
|
<source-position filename="gsocket.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35488">the file descriptor of the socket.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35480">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_keepalive" c:identifier="g_socket_get_keepalive" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35493">Gets the keepalive mode of the socket. For details on this,
|
|
see g_socket_set_keepalive().</doc>
|
|
<source-position filename="gsocket.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35500">%TRUE if keepalive is active, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35495">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_listen_backlog" c:identifier="g_socket_get_listen_backlog" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35505">Gets the listen backlog setting of the socket. For details on this,
|
|
see g_socket_set_listen_backlog().</doc>
|
|
<source-position filename="gsocket.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35512">the maximum number of pending connections.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35507">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_local_address" c:identifier="g_socket_get_local_address" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35517">Try to get the local address of a bound socket. This is only
|
|
useful if the socket has been bound to a local address,
|
|
either explicitly or implicitly when connecting.</doc>
|
|
<source-position filename="gsocket.h" line="93"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35526">a #GSocketAddress or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35519">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_multicast_loopback" c:identifier="g_socket_get_multicast_loopback" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35532">Gets the multicast loopback setting on @socket; if %TRUE (the
|
|
default), outgoing multicast packets will be looped back to
|
|
multicast listeners on the same host.</doc>
|
|
<source-position filename="gsocket.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35540">the multicast loopback setting on @socket</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35534">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_multicast_ttl" c:identifier="g_socket_get_multicast_ttl" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35545">Gets the multicast time-to-live setting on @socket; see
|
|
g_socket_set_multicast_ttl() for more details.</doc>
|
|
<source-position filename="gsocket.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35552">the multicast time-to-live setting on @socket</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35547">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_option" c:identifier="g_socket_get_option" version="2.36" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35557">Gets the value of an integer-valued option on @socket, as with
|
|
getsockopt(). (If you need to fetch a non-integer-valued option,
|
|
you will need to call getsockopt() directly.)
|
|
|
|
The [<gio/gnetworking.h>][gio-gnetworking.h]
|
|
header pulls in system headers that will define most of the
|
|
standard/portable socket options. For unusual socket protocols or
|
|
platform-dependent options, you may need to include additional
|
|
headers.
|
|
|
|
Note that even for socket options that are a single byte in size,
|
|
@value is still a pointer to a #gint variable, not a #guchar;
|
|
g_socket_get_option() will handle the conversion internally.</doc>
|
|
<source-position filename="gsocket.h" line="314"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35579">success or failure. On failure, @error will be set, and
|
|
the system error value (`errno` or WSAGetLastError()) will still
|
|
be set to the result of the getsockopt() call.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35559">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="level" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35560">the "API level" of the option (eg, `SOL_SOCKET`)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="optname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35561">the "name" of the option (eg, `SO_BROADCAST`)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="value" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35562">return location for the option value</doc>
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_protocol" c:identifier="g_socket_get_protocol" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35586">Gets the socket protocol id the socket was created with.
|
|
In case the protocol is unknown, -1 is returned.</doc>
|
|
<source-position filename="gsocket.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35593">a protocol id, or -1 if unknown</doc>
|
|
<type name="SocketProtocol" c:type="GSocketProtocol"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35588">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_remote_address" c:identifier="g_socket_get_remote_address" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35598">Try to get the remote address of a connected socket. This is only
|
|
useful for connection oriented sockets that have been connected.</doc>
|
|
<source-position filename="gsocket.h" line="96"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35606">a #GSocketAddress or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35600">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_socket_type" c:identifier="g_socket_get_socket_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35612">Gets the socket type of the socket.</doc>
|
|
<source-position filename="gsocket.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35618">a #GSocketType</doc>
|
|
<type name="SocketType" c:type="GSocketType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35614">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_timeout" c:identifier="g_socket_get_timeout" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35623">Gets the timeout setting of the socket. For details on this, see
|
|
g_socket_set_timeout().</doc>
|
|
<source-position filename="gsocket.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35630">the timeout in seconds</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35625">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_ttl" c:identifier="g_socket_get_ttl" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35635">Gets the unicast time-to-live setting on @socket; see
|
|
g_socket_set_ttl() for more details.</doc>
|
|
<source-position filename="gsocket.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35642">the time-to-live setting on @socket</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35637">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_closed" c:identifier="g_socket_is_closed" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35647">Checks whether a socket is closed.</doc>
|
|
<source-position filename="gsocket.h" line="276"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35653">%TRUE if socket is closed, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35649">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_connected" c:identifier="g_socket_is_connected" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35658">Check whether the socket is connected. This is only useful for
|
|
connection-oriented sockets.
|
|
|
|
If using g_socket_shutdown(), this function will return %TRUE until the
|
|
socket has been shut down for reading and writing. If you do a non-blocking
|
|
connect, this function will not return %TRUE until after you call
|
|
g_socket_check_connect_result().</doc>
|
|
<source-position filename="gsocket.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35670">%TRUE if socket is connected, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35660">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="join_multicast_group" c:identifier="g_socket_join_multicast_group" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35675">Registers @socket to receive multicast messages sent to @group.
|
|
@socket must be a %G_SOCKET_TYPE_DATAGRAM socket, and must have
|
|
been bound to an appropriate interface and port with
|
|
g_socket_bind().
|
|
|
|
If @iface is %NULL, the system will automatically pick an interface
|
|
to bind to based on @group.
|
|
|
|
If @source_specific is %TRUE, source-specific multicast as defined
|
|
in RFC 4604 is used. Note that on older platforms this may fail
|
|
with a %G_IO_ERROR_NOT_SUPPORTED error.
|
|
|
|
To bind to a given source-specific multicast address, use
|
|
g_socket_join_multicast_group_ssm() instead.</doc>
|
|
<source-position filename="gsocket.h" line="149"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35698">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35677">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35678">a #GInetAddress specifying the group address to join.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="source_specific" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35680">%TRUE if source-specific multicast should be used</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="iface" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35679">Name of the interface to use, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="join_multicast_group_ssm" c:identifier="g_socket_join_multicast_group_ssm" version="2.56" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35703">Registers @socket to receive multicast messages sent to @group.
|
|
@socket must be a %G_SOCKET_TYPE_DATAGRAM socket, and must have
|
|
been bound to an appropriate interface and port with
|
|
g_socket_bind().
|
|
|
|
If @iface is %NULL, the system will automatically pick an interface
|
|
to bind to based on @group.
|
|
|
|
If @source_specific is not %NULL, use source-specific multicast as
|
|
defined in RFC 4604. Note that on older platforms this may fail
|
|
with a %G_IO_ERROR_NOT_SUPPORTED error.
|
|
|
|
Note that this function can be called multiple times for the same
|
|
@group with different @source_specific in order to receive multicast
|
|
packets from more than one source.</doc>
|
|
<source-position filename="gsocket.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35728">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35705">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35706">a #GInetAddress specifying the group address to join.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="source_specific" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35707">a #GInetAddress specifying the
|
|
source-specific multicast address or %NULL to ignore.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="iface" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35709">Name of the interface to use, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="leave_multicast_group" c:identifier="g_socket_leave_multicast_group" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35733">Removes @socket from the multicast group defined by @group, @iface,
|
|
and @source_specific (which must all have the same values they had
|
|
when you joined the group).
|
|
|
|
@socket remains bound to its address and port, and can still receive
|
|
unicast messages after calling this.
|
|
|
|
To unbind to a given source-specific multicast address, use
|
|
g_socket_leave_multicast_group_ssm() instead.</doc>
|
|
<source-position filename="gsocket.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35751">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35735">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35736">a #GInetAddress specifying the group address to leave.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="source_specific" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35738">%TRUE if source-specific multicast was used</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="iface" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35737">Interface used</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="leave_multicast_group_ssm" c:identifier="g_socket_leave_multicast_group_ssm" version="2.56" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35756">Removes @socket from the multicast group defined by @group, @iface,
|
|
and @source_specific (which must all have the same values they had
|
|
when you joined the group).
|
|
|
|
@socket remains bound to its address and port, and can still receive
|
|
unicast messages after calling this.</doc>
|
|
<source-position filename="gsocket.h" line="167"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35772">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35758">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="group" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35759">a #GInetAddress specifying the group address to leave.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="source_specific" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35760">a #GInetAddress specifying the
|
|
source-specific multicast address or %NULL to ignore.</doc>
|
|
<type name="InetAddress" c:type="GInetAddress*"/>
|
|
</parameter>
|
|
<parameter name="iface" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35762">Name of the interface to use, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="listen" c:identifier="g_socket_listen" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35777">Marks the socket as a server socket, i.e. a socket that is used
|
|
to accept incoming requests using g_socket_accept().
|
|
|
|
Before calling this the socket must be bound to a local address using
|
|
g_socket_bind().
|
|
|
|
To set the maximum amount of outstanding clients, use
|
|
g_socket_set_listen_backlog().</doc>
|
|
<source-position filename="gsocket.h" line="203"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35791">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35779">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive" c:identifier="g_socket_receive" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36113">Receive data (up to @size bytes) from a socket. This is mainly used by
|
|
connection-oriented sockets; it is identical to g_socket_receive_from()
|
|
with @address set to %NULL.
|
|
|
|
For %G_SOCKET_TYPE_DATAGRAM and %G_SOCKET_TYPE_SEQPACKET sockets,
|
|
g_socket_receive() will always read either 0 or 1 complete messages from
|
|
the socket. If the received message is too large to fit in @buffer, then
|
|
the data beyond @size bytes will be discarded, without any explicit
|
|
indication that this has occurred.
|
|
|
|
For %G_SOCKET_TYPE_STREAM sockets, g_socket_receive() can return any
|
|
number of bytes, up to @size. If more than @size bytes have been
|
|
received, the additional data will be returned in future calls to
|
|
g_socket_receive().
|
|
|
|
If the socket is in blocking mode the call will block until there
|
|
is some data to receive, the connection is closed, or there is an
|
|
error. If there is no data available and the socket is in
|
|
non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error will be
|
|
returned. To be notified when data is available, wait for the
|
|
%G_IO_IN condition.
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="gsocket.h" line="206"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36146">Number of bytes read, or 0 if the connection was closed by
|
|
the peer, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36115">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36116">a buffer to
|
|
read data into (which should be at least @size bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="gchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36118">the number of bytes you want to read from the socket</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36119">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_from" c:identifier="g_socket_receive_from" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36152">Receive data (up to @size bytes) from a socket.
|
|
|
|
If @address is non-%NULL then @address will be set equal to the
|
|
source address of the received packet.
|
|
@address is owned by the caller.
|
|
|
|
See g_socket_receive() for additional information.</doc>
|
|
<source-position filename="gsocket.h" line="212"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36171">Number of bytes read, or 0 if the connection was closed by
|
|
the peer, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36154">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36155">a pointer to a #GSocketAddress
|
|
pointer, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress**"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36157">a buffer to
|
|
read data into (which should be at least @size bytes long).</doc>
|
|
<array length="2" zero-terminated="0" c:type="gchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36159">the number of bytes you want to read from the socket</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36160">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_message" c:identifier="g_socket_receive_message" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36177">Receive data from a socket. For receiving multiple messages, see
|
|
g_socket_receive_messages(); for easier use, see
|
|
g_socket_receive() and g_socket_receive_from().
|
|
|
|
If @address is non-%NULL then @address will be set equal to the
|
|
source address of the received packet.
|
|
@address is owned by the caller.
|
|
|
|
@vector must point to an array of #GInputVector structs and
|
|
@num_vectors must be the length of this array. These structs
|
|
describe the buffers that received data will be scattered into.
|
|
If @num_vectors is -1, then @vectors is assumed to be terminated
|
|
by a #GInputVector with a %NULL buffer pointer.
|
|
|
|
As a special case, if @num_vectors is 0 (in which case, @vectors
|
|
may of course be %NULL), then a single byte is received and
|
|
discarded. This is to facilitate the common practice of sending a
|
|
single '\0' byte for the purposes of transferring ancillary data.
|
|
|
|
@messages, if non-%NULL, will be set to point to a newly-allocated
|
|
array of #GSocketControlMessage instances or %NULL if no such
|
|
messages was received. These correspond to the control messages
|
|
received from the kernel, one #GSocketControlMessage per message
|
|
from the kernel. This array is %NULL-terminated and must be freed
|
|
by the caller using g_free() after calling g_object_unref() on each
|
|
element. If @messages is %NULL, any control messages received will
|
|
be discarded.
|
|
|
|
@num_messages, if non-%NULL, will be set to the number of control
|
|
messages received.
|
|
|
|
If both @messages and @num_messages are non-%NULL, then
|
|
@num_messages gives the number of #GSocketControlMessage instances
|
|
in @messages (ie: not including the %NULL terminator).
|
|
|
|
@flags is an in/out parameter. The commonly available arguments
|
|
for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too
|
|
(and g_socket_receive_message() may pass system-specific flags out).
|
|
Flags passed in to the parameter affect the receive operation; flags returned
|
|
out of it are relevant to the specific returned message.
|
|
|
|
As with g_socket_receive(), data may be discarded if @socket is
|
|
%G_SOCKET_TYPE_DATAGRAM or %G_SOCKET_TYPE_SEQPACKET and you do not
|
|
provide enough buffer space to read a complete message. You can pass
|
|
%G_SOCKET_MSG_PEEK in @flags to peek at the current message without
|
|
removing it from the receive queue, but there is no portable way to find
|
|
out the length of the message other than by reading it into a
|
|
sufficiently-large buffer.
|
|
|
|
If the socket is in blocking mode the call will block until there
|
|
is some data to receive, the connection is closed, or there is an
|
|
error. If there is no data available and the socket is in
|
|
non-blocking mode, a %G_IO_ERROR_WOULD_BLOCK error will be
|
|
returned. To be notified when data is available, wait for the
|
|
%G_IO_IN condition.
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="gsocket.h" line="232"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36254">Number of bytes read, or 0 if the connection was closed by
|
|
the peer, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36179">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36180">a pointer to a #GSocketAddress
|
|
pointer, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress**"/>
|
|
</parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36182">an array of #GInputVector structs</doc>
|
|
<array length="2" zero-terminated="0" c:type="GInputVector*">
|
|
<type name="InputVector" c:type="GInputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36183">the number of elements in @vectors, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="messages" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36184">a pointer
|
|
which may be filled with an array of #GSocketControlMessages, or %NULL</doc>
|
|
<array length="4" zero-terminated="0" c:type="GSocketControlMessage***">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage**"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36186">a pointer which will be filled with the number of
|
|
elements in @messages, or %NULL</doc>
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
<parameter name="flags" direction="inout" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36188">a pointer to an int containing #GSocketMsgFlags flags,
|
|
which may additionally contain
|
|
[other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)</doc>
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36191">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_messages" c:identifier="g_socket_receive_messages" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36260">Receive multiple data messages from @socket in one go. This is the most
|
|
complicated and fully-featured version of this call. For easier use, see
|
|
g_socket_receive(), g_socket_receive_from(), and g_socket_receive_message().
|
|
|
|
@messages must point to an array of #GInputMessage structs and
|
|
@num_messages must be the length of this array. Each #GInputMessage
|
|
contains a pointer to an array of #GInputVector structs describing the
|
|
buffers that the data received in each message will be written to. Using
|
|
multiple #GInputVectors is more memory-efficient than manually copying data
|
|
out of a single buffer to multiple sources, and more system-call-efficient
|
|
than making multiple calls to g_socket_receive(), such as in scenarios where
|
|
a lot of data packets need to be received (e.g. high-bandwidth video
|
|
streaming over RTP/UDP).
|
|
|
|
@flags modify how all messages are received. The commonly available
|
|
arguments for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too. These
|
|
flags affect the overall receive operation. Flags affecting individual
|
|
messages are returned in #GInputMessage.flags.
|
|
|
|
The other members of #GInputMessage are treated as described in its
|
|
documentation.
|
|
|
|
If #GSocket:blocking is %TRUE the call will block until @num_messages have
|
|
been received, or the end of the stream is reached.
|
|
|
|
If #GSocket:blocking is %FALSE the call will return up to @num_messages
|
|
without blocking, or %G_IO_ERROR_WOULD_BLOCK if no messages are queued in the
|
|
operating system to be received.
|
|
|
|
In blocking mode, if #GSocket:timeout is positive and is reached before any
|
|
messages are received, %G_IO_ERROR_TIMED_OUT is returned, otherwise up to
|
|
@num_messages are returned. (Note: This is effectively the
|
|
behaviour of `MSG_WAITFORONE` with recvmmsg().)
|
|
|
|
To be notified when messages are available, wait for the
|
|
%G_IO_IN condition. Note though that you may still receive
|
|
%G_IO_ERROR_WOULD_BLOCK from g_socket_receive_messages() even if you were
|
|
previously notified of a %G_IO_IN condition.
|
|
|
|
If the remote peer closes the connection, any messages queued in the
|
|
operating system will be returned, and subsequent calls to
|
|
g_socket_receive_messages() will return 0 (with no error set).
|
|
|
|
On error -1 is returned and @error is set accordingly. An error will only
|
|
be returned if zero messages could be received; otherwise the number of
|
|
messages successfully received before the error will be returned.</doc>
|
|
<source-position filename="gsocket.h" line="253"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36320">number of messages received, or -1 on error. Note that the number
|
|
of messages received may be smaller than @num_messages if in non-blocking
|
|
mode, if the peer closed the connection, or if @num_messages
|
|
was larger than `UIO_MAXIOV` (1024), in which case the caller may re-try
|
|
to receive the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36262">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36263">an array of #GInputMessage structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="GInputMessage*">
|
|
<type name="InputMessage" c:type="GInputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36264">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36265">an int containing #GSocketMsgFlags flags for the overall operation,
|
|
which may additionally contain
|
|
[other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36268">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_with_blocking" c:identifier="g_socket_receive_with_blocking" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36329">This behaves exactly the same as g_socket_receive(), except that
|
|
the choice of blocking or non-blocking behavior is determined by
|
|
the @blocking argument rather than by @socket's properties.</doc>
|
|
<source-position filename="gsocket.h" line="288"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36343">Number of bytes read, or 0 if the connection was closed by
|
|
the peer, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36331">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36332">a buffer to
|
|
read data into (which should be at least @size bytes long).</doc>
|
|
<array length="1" zero-terminated="0" c:type="gchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36334">the number of bytes you want to read from the socket</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="blocking" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36335">whether to do blocking or non-blocking I/O</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36336">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send" c:identifier="g_socket_send" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36349">Tries to send @size bytes from @buffer on the socket. This is
|
|
mainly used by connection-oriented sockets; it is identical to
|
|
g_socket_send_to() with @address set to %NULL.
|
|
|
|
If the socket is in blocking mode the call will block until there is
|
|
space for the data in the socket queue. If there is no space available
|
|
and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
|
|
will be returned. To be notified when space is available, wait for the
|
|
%G_IO_OUT condition. Note though that you may still receive
|
|
%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
|
|
notified of a %G_IO_OUT condition. (On Windows in particular, this is
|
|
very common due to the way the underlying APIs work.)
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="gsocket.h" line="219"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36373">Number of bytes written (which may be less than @size), or -1
|
|
on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36351">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36352">the buffer
|
|
containing the data to send.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const gchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36354">the number of bytes to send</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36355">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_message" c:identifier="g_socket_send_message" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36379">Send data to @address on @socket. For sending multiple messages see
|
|
g_socket_send_messages(); for easier use, see
|
|
g_socket_send() and g_socket_send_to().
|
|
|
|
If @address is %NULL then the message is sent to the default receiver
|
|
(set by g_socket_connect()).
|
|
|
|
@vectors must point to an array of #GOutputVector structs and
|
|
@num_vectors must be the length of this array. (If @num_vectors is -1,
|
|
then @vectors is assumed to be terminated by a #GOutputVector with a
|
|
%NULL buffer pointer.) The #GOutputVector structs describe the buffers
|
|
that the sent data will be gathered from. Using multiple
|
|
#GOutputVectors is more memory-efficient than manually copying
|
|
data from multiple sources into a single buffer, and more
|
|
network-efficient than making multiple calls to g_socket_send().
|
|
|
|
@messages, if non-%NULL, is taken to point to an array of @num_messages
|
|
#GSocketControlMessage instances. These correspond to the control
|
|
messages to be sent on the socket.
|
|
If @num_messages is -1 then @messages is treated as a %NULL-terminated
|
|
array.
|
|
|
|
@flags modify how the message is sent. The commonly available arguments
|
|
for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too.
|
|
|
|
If the socket is in blocking mode the call will block until there is
|
|
space for the data in the socket queue. If there is no space available
|
|
and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
|
|
will be returned. To be notified when space is available, wait for the
|
|
%G_IO_OUT condition. Note though that you may still receive
|
|
%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
|
|
notified of a %G_IO_OUT condition. (On Windows in particular, this is
|
|
very common due to the way the underlying APIs work.)
|
|
|
|
On error -1 is returned and @error is set accordingly.</doc>
|
|
<source-position filename="gsocket.h" line="242"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36431">Number of bytes written (which may be less than @size), or -1
|
|
on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36381">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36382">a #GSocketAddress, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36383">an array of #GOutputVector structs</doc>
|
|
<array length="2" zero-terminated="0" c:type="GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36384">the number of elements in @vectors, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="messages" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36385">a pointer to an
|
|
array of #GSocketControlMessages, or %NULL.</doc>
|
|
<array length="4" zero-terminated="0" c:type="GSocketControlMessage**">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36387">number of elements in @messages, or -1.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36388">an int containing #GSocketMsgFlags flags, which may additionally
|
|
contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36390">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_message_with_timeout" c:identifier="g_socket_send_message_with_timeout" version="2.60" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36437">This behaves exactly the same as g_socket_send_message(), except that
|
|
the choice of timeout behavior is determined by the @timeout_us argument
|
|
rather than by @socket's properties.
|
|
|
|
On error %G_POLLABLE_RETURN_FAILED is returned and @error is set accordingly, or
|
|
if the socket is currently not writable %G_POLLABLE_RETURN_WOULD_BLOCK is
|
|
returned. @bytes_written will contain 0 in both cases.</doc>
|
|
<source-position filename="gsocket.h" line="302"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36461">%G_POLLABLE_RETURN_OK if all data was successfully written,
|
|
%G_POLLABLE_RETURN_WOULD_BLOCK if the socket is currently not writable, or
|
|
%G_POLLABLE_RETURN_FAILED if an error happened and @error is set.</doc>
|
|
<type name="PollableReturn" c:type="GPollableReturn"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36439">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36440">a #GSocketAddress, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36441">an array of #GOutputVector structs</doc>
|
|
<array length="2" zero-terminated="0" c:type="const GOutputVector*">
|
|
<type name="OutputVector" c:type="GOutputVector"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_vectors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36442">the number of elements in @vectors, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="messages" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36443">a pointer to an
|
|
array of #GSocketControlMessages, or %NULL.</doc>
|
|
<array length="4" zero-terminated="0" c:type="GSocketControlMessage**">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36445">number of elements in @messages, or -1.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36446">an int containing #GSocketMsgFlags flags, which may additionally
|
|
contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="timeout_us" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36448">the maximum time (in microseconds) to wait, or -1</doc>
|
|
<type name="gint64" c:type="gint64"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36449">location to store the number of bytes that were written to the socket</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36450">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_messages" c:identifier="g_socket_send_messages" version="2.44" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36468">Send multiple data messages from @socket in one go. This is the most
|
|
complicated and fully-featured version of this call. For easier use, see
|
|
g_socket_send(), g_socket_send_to(), and g_socket_send_message().
|
|
|
|
@messages must point to an array of #GOutputMessage structs and
|
|
@num_messages must be the length of this array. Each #GOutputMessage
|
|
contains an address to send the data to, and a pointer to an array of
|
|
#GOutputVector structs to describe the buffers that the data to be sent
|
|
for each message will be gathered from. Using multiple #GOutputVectors is
|
|
more memory-efficient than manually copying data from multiple sources
|
|
into a single buffer, and more network-efficient than making multiple
|
|
calls to g_socket_send(). Sending multiple messages in one go avoids the
|
|
overhead of making a lot of syscalls in scenarios where a lot of data
|
|
packets need to be sent (e.g. high-bandwidth video streaming over RTP/UDP),
|
|
or where the same data needs to be sent to multiple recipients.
|
|
|
|
@flags modify how the message is sent. The commonly available arguments
|
|
for this are available in the #GSocketMsgFlags enum, but the
|
|
values there are the same as the system values, and the flags
|
|
are passed in as-is, so you can pass in system-specific flags too.
|
|
|
|
If the socket is in blocking mode the call will block until there is
|
|
space for all the data in the socket queue. If there is no space available
|
|
and the socket is in non-blocking mode a %G_IO_ERROR_WOULD_BLOCK error
|
|
will be returned if no data was written at all, otherwise the number of
|
|
messages sent will be returned. To be notified when space is available,
|
|
wait for the %G_IO_OUT condition. Note though that you may still receive
|
|
%G_IO_ERROR_WOULD_BLOCK from g_socket_send() even if you were previously
|
|
notified of a %G_IO_OUT condition. (On Windows in particular, this is
|
|
very common due to the way the underlying APIs work.)
|
|
|
|
On error -1 is returned and @error is set accordingly. An error will only
|
|
be returned if zero messages could be sent; otherwise the number of messages
|
|
successfully sent before the error will be returned.</doc>
|
|
<source-position filename="gsocket.h" line="260"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36513">number of messages sent, or -1 on error. Note that the number of
|
|
messages sent may be smaller than @num_messages if the socket is
|
|
non-blocking or if @num_messages was larger than UIO_MAXIOV (1024),
|
|
in which case the caller may re-try to send the remaining messages.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36470">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36471">an array of #GOutputMessage structs</doc>
|
|
<array length="1" zero-terminated="0" c:type="GOutputMessage*">
|
|
<type name="OutputMessage" c:type="GOutputMessage"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_messages" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36472">the number of elements in @messages</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36473">an int containing #GSocketMsgFlags flags, which may additionally
|
|
contain [other platform specific flags](http://man7.org/linux/man-pages/man2/recv.2.html)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36475">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_to" c:identifier="g_socket_send_to" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36521">Tries to send @size bytes from @buffer to @address. If @address is
|
|
%NULL then the message is sent to the default receiver (set by
|
|
g_socket_connect()).
|
|
|
|
See g_socket_send() for additional information.</doc>
|
|
<source-position filename="gsocket.h" line="225"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36537">Number of bytes written (which may be less than @size), or -1
|
|
on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36523">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36524">a #GSocketAddress, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36525">the buffer
|
|
containing the data to send.</doc>
|
|
<array length="2" zero-terminated="0" c:type="const gchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36527">the number of bytes to send</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36528">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_with_blocking" c:identifier="g_socket_send_with_blocking" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36543">This behaves exactly the same as g_socket_send(), except that
|
|
the choice of blocking or non-blocking behavior is determined by
|
|
the @blocking argument rather than by @socket's properties.</doc>
|
|
<source-position filename="gsocket.h" line="295"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36557">Number of bytes written (which may be less than @size), or -1
|
|
on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36545">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36546">the buffer
|
|
containing the data to send.</doc>
|
|
<array length="1" zero-terminated="0" c:type="const gchar*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36548">the number of bytes to send</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="blocking" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36549">whether to do blocking or non-blocking I/O</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36550">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_blocking" c:identifier="g_socket_set_blocking" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36633">Sets the blocking mode of the socket. In blocking mode
|
|
all operations (which don’t take an explicit blocking parameter) block until
|
|
they succeed or there is an error. In
|
|
non-blocking mode all functions return results immediately or
|
|
with a %G_IO_ERROR_WOULD_BLOCK error.
|
|
|
|
All sockets are created in blocking mode. However, note that the
|
|
platform level socket is always non-blocking, and blocking mode
|
|
is a GSocket level feature.</doc>
|
|
<source-position filename="gsocket.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36635">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="blocking" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36636">Whether to use blocking I/O or not.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_broadcast" c:identifier="g_socket_set_broadcast" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36652">Sets whether @socket should allow sending to broadcast addresses.
|
|
This is %FALSE by default.</doc>
|
|
<source-position filename="gsocket.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36654">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="broadcast" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36655">whether @socket should allow sending to broadcast
|
|
addresses</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_keepalive" c:identifier="g_socket_set_keepalive" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36665">Sets or unsets the %SO_KEEPALIVE flag on the underlying socket. When
|
|
this flag is set on a socket, the system will attempt to verify that the
|
|
remote socket endpoint is still present if a sufficiently long period of
|
|
time passes with no data being exchanged. If the system is unable to
|
|
verify the presence of the remote endpoint, it will automatically close
|
|
the connection.
|
|
|
|
This option is only functional on certain kinds of sockets. (Notably,
|
|
%G_SOCKET_PROTOCOL_TCP sockets.)
|
|
|
|
The exact time between pings is system- and protocol-dependent, but will
|
|
normally be at least two hours. Most commonly, you would set this flag
|
|
on a server socket if you want to allow clients to remain idle for long
|
|
periods of time, but also want to ensure that connections are eventually
|
|
garbage-collected if clients crash or become unreachable.</doc>
|
|
<source-position filename="gsocket.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36667">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="keepalive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36668">Value for the keepalive flag</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_listen_backlog" c:identifier="g_socket_set_listen_backlog" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36690">Sets the maximum number of outstanding connections allowed
|
|
when listening on this socket. If more clients than this are
|
|
connecting to the socket and the application is not handling them
|
|
on time then the new connections will be refused.
|
|
|
|
Note that this must be called before g_socket_listen() and has no
|
|
effect if called after that.</doc>
|
|
<source-position filename="gsocket.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36692">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="backlog" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36693">the maximum number of pending connections.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_multicast_loopback" c:identifier="g_socket_set_multicast_loopback" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36707">Sets whether outgoing multicast packets will be received by sockets
|
|
listening on that multicast address on the same host. This is %TRUE
|
|
by default.</doc>
|
|
<source-position filename="gsocket.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36709">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="loopback" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36710">whether @socket should receive messages sent to its
|
|
multicast groups from the local host</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_multicast_ttl" c:identifier="g_socket_set_multicast_ttl" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36721">Sets the time-to-live for outgoing multicast datagrams on @socket.
|
|
By default, this is 1, meaning that multicast packets will not leave
|
|
the local network.</doc>
|
|
<source-position filename="gsocket.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36723">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="ttl" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36724">the time-to-live value for all multicast datagrams on @socket</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_option" c:identifier="g_socket_set_option" version="2.36" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36734">Sets the value of an integer-valued option on @socket, as with
|
|
setsockopt(). (If you need to set a non-integer-valued option,
|
|
you will need to call setsockopt() directly.)
|
|
|
|
The [<gio/gnetworking.h>][gio-gnetworking.h]
|
|
header pulls in system headers that will define most of the
|
|
standard/portable socket options. For unusual socket protocols or
|
|
platform-dependent options, you may need to include additional
|
|
headers.</doc>
|
|
<source-position filename="gsocket.h" line="320"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36752">success or failure. On failure, @error will be set, and
|
|
the system error value (`errno` or WSAGetLastError()) will still
|
|
be set to the result of the setsockopt() call.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36736">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="level" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36737">the "API level" of the option (eg, `SOL_SOCKET`)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="optname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36738">the "name" of the option (eg, `SO_BROADCAST`)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36739">the value to set the option to</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_timeout" c:identifier="g_socket_set_timeout" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36759">Sets the time in seconds after which I/O operations on @socket will
|
|
time out if they have not yet completed.
|
|
|
|
On a blocking socket, this means that any blocking #GSocket
|
|
operation will time out after @timeout seconds of inactivity,
|
|
returning %G_IO_ERROR_TIMED_OUT.
|
|
|
|
On a non-blocking socket, calls to g_socket_condition_wait() will
|
|
also fail with %G_IO_ERROR_TIMED_OUT after the given time. Sources
|
|
created with g_socket_create_source() will trigger after
|
|
@timeout seconds of inactivity, with the requested condition
|
|
set, at which point calling g_socket_receive(), g_socket_send(),
|
|
g_socket_check_connect_result(), etc, will fail with
|
|
%G_IO_ERROR_TIMED_OUT.
|
|
|
|
If @timeout is 0 (the default), operations will never time out
|
|
on their own.
|
|
|
|
Note that if an I/O operation is interrupted by a signal, this may
|
|
cause the timeout to be reset.</doc>
|
|
<source-position filename="gsocket.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36761">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36762">the timeout for @socket, in seconds, or 0 for none</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_ttl" c:identifier="g_socket_set_ttl" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36789">Sets the time-to-live for outgoing unicast packets on @socket.
|
|
By default the platform-specific default value is used.</doc>
|
|
<source-position filename="gsocket.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36791">a #GSocket.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="ttl" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36792">the time-to-live value for all unicast packets on @socket</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="shutdown" c:identifier="g_socket_shutdown" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36801">Shut down part or all of a full-duplex connection.
|
|
|
|
If @shutdown_read is %TRUE then the receiving side of the connection
|
|
is shut down, and further reading is disallowed.
|
|
|
|
If @shutdown_write is %TRUE then the sending side of the connection
|
|
is shut down, and further writing is disallowed.
|
|
|
|
It is allowed for both @shutdown_read and @shutdown_write to be %TRUE.
|
|
|
|
One example where it is useful to shut down only one side of a connection is
|
|
graceful disconnect for TCP connections where you close the sending side,
|
|
then wait for the other side to close the connection, thus ensuring that the
|
|
other side saw all sent data.</doc>
|
|
<source-position filename="gsocket.h" line="271"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36823">%TRUE on success, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36803">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
<parameter name="shutdown_read" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36804">whether to shut down the read side</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="shutdown_write" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36805">whether to shut down the write side</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="speaks_ipv4" c:identifier="g_socket_speaks_ipv4" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36828">Checks if a socket is capable of speaking IPv4.
|
|
|
|
IPv4 sockets are capable of speaking IPv4. On some operating systems
|
|
and under some combinations of circumstances IPv6 sockets are also
|
|
capable of speaking IPv4. See RFC 3493 section 3.7 for more
|
|
information.
|
|
|
|
No other types of sockets are currently considered as being capable
|
|
of speaking IPv4.</doc>
|
|
<source-position filename="gsocket.h" line="282"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36842">%TRUE if this socket can be used with IPv4.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36830">a #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="blocking" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="broadcast" version="2.32" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3231">Whether the socket should allow sending to broadcast addresses.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="family" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="SocketFamily"/>
|
|
</property>
|
|
<property name="fd" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<property name="keepalive" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="listen-backlog" writable="1" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<property name="local-address" transfer-ownership="none">
|
|
<type name="SocketAddress"/>
|
|
</property>
|
|
<property name="multicast-loopback" version="2.32" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3240">Whether outgoing multicast packets loop back to the local host.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="multicast-ttl" version="2.32" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3249">Time-to-live out outgoing multicast packets</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="protocol" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="SocketProtocol"/>
|
|
</property>
|
|
<property name="remote-address" transfer-ownership="none">
|
|
<type name="SocketAddress"/>
|
|
</property>
|
|
<property name="timeout" version="2.26" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3258">The timeout in seconds on socket I/O</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="ttl" version="2.32" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3267">Time-to-live for outgoing unicast packets</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="type" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="SocketType"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="SocketPrivate" c:type="GSocketPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<class name="SocketAddress" c:symbol-prefix="socket_address" c:type="GSocketAddress" parent="GObject.Object" abstract="1" glib:type-name="GSocketAddress" glib:get-type="g_socket_address_get_type" glib:type-struct="SocketAddressClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8365">#GSocketAddress is the equivalent of struct sockaddr in the BSD
|
|
sockets API. This is an abstract class; use #GInetSocketAddress
|
|
for internet sockets, or #GUnixSocketAddress for UNIX domain sockets.</doc>
|
|
<source-position filename="gsocketaddress.h" line="59"/>
|
|
<implements name="SocketConnectable"/>
|
|
<constructor name="new_from_native" c:identifier="g_socket_address_new_from_native" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34282">Creates a #GSocketAddress subclass corresponding to the native
|
|
struct sockaddr @native.</doc>
|
|
<source-position filename="gsocketaddress.h" line="68"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34290">a new #GSocketAddress if @native could successfully
|
|
be converted, otherwise %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="native" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34284">a pointer to a struct sockaddr</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34285">the size of the memory location pointed to by @native</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<virtual-method name="get_family" invoker="get_family" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34257">Gets the socket family type of @address.</doc>
|
|
<source-position filename="gsocketaddress.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34263">the socket family type of @address</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34259">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_native_size" invoker="get_native_size" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34268">Gets the size of @address's native struct sockaddr.
|
|
You can use this to allocate memory to pass to
|
|
g_socket_address_to_native().</doc>
|
|
<source-position filename="gsocketaddress.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34276">the size of the native struct sockaddr that
|
|
@address represents</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34270">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="to_native" invoker="to_native" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34296">Converts a #GSocketAddress to a native struct sockaddr, which can
|
|
be passed to low-level functions like connect() or bind().
|
|
|
|
If not enough space is available, a %G_IO_ERROR_NO_SPACE error
|
|
is returned. If the address type is not known on the system
|
|
then a %G_IO_ERROR_NOT_SUPPORTED error is returned.</doc>
|
|
<source-position filename="gsocketaddress.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34312">%TRUE if @dest was filled in, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34298">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</instance-parameter>
|
|
<parameter name="dest" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34299">a pointer to a memory location that will contain the native
|
|
struct sockaddr</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="destlen" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34301">the size of @dest. Must be at least as large as
|
|
g_socket_address_get_native_size()</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_family" c:identifier="g_socket_address_get_family" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34257">Gets the socket family type of @address.</doc>
|
|
<source-position filename="gsocketaddress.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34263">the socket family type of @address</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34259">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_native_size" c:identifier="g_socket_address_get_native_size" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34268">Gets the size of @address's native struct sockaddr.
|
|
You can use this to allocate memory to pass to
|
|
g_socket_address_to_native().</doc>
|
|
<source-position filename="gsocketaddress.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34276">the size of the native struct sockaddr that
|
|
@address represents</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34270">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_native" c:identifier="g_socket_address_to_native" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34296">Converts a #GSocketAddress to a native struct sockaddr, which can
|
|
be passed to low-level functions like connect() or bind().
|
|
|
|
If not enough space is available, a %G_IO_ERROR_NO_SPACE error
|
|
is returned. If the address type is not known on the system
|
|
then a %G_IO_ERROR_NOT_SUPPORTED error is returned.</doc>
|
|
<source-position filename="gsocketaddress.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34312">%TRUE if @dest was filled in, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34298">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</instance-parameter>
|
|
<parameter name="dest" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34299">a pointer to a memory location that will contain the native
|
|
struct sockaddr</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="destlen" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34301">the size of @dest. Must be at least as large as
|
|
g_socket_address_get_native_size()</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="family" transfer-ownership="none">
|
|
<type name="SocketFamily"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
</class>
|
|
<record name="SocketAddressClass" c:type="GSocketAddressClass" glib:is-gtype-struct-for="SocketAddress">
|
|
<source-position filename="gsocketaddress.h" line="59"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_family">
|
|
<callback name="get_family">
|
|
<source-position filename="gsocketaddress.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34263">the socket family type of @address</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34259">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_native_size">
|
|
<callback name="get_native_size">
|
|
<source-position filename="gsocketaddress.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34276">the size of the native struct sockaddr that
|
|
@address represents</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34270">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="to_native">
|
|
<callback name="to_native" throws="1">
|
|
<source-position filename="gsocketaddress.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34312">%TRUE if @dest was filled in, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34298">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="dest" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34299">a pointer to a memory location that will contain the native
|
|
struct sockaddr</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="destlen" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34301">the size of @dest. Must be at least as large as
|
|
g_socket_address_get_native_size()</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="SocketAddressEnumerator" c:symbol-prefix="socket_address_enumerator" c:type="GSocketAddressEnumerator" parent="GObject.Object" abstract="1" glib:type-name="GSocketAddressEnumerator" glib:get-type="g_socket_address_enumerator_get_type" glib:type-struct="SocketAddressEnumeratorClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8377">#GSocketAddressEnumerator is an enumerator type for #GSocketAddress
|
|
instances. It is returned by enumeration functions such as
|
|
g_socket_connectable_enumerate(), which returns a #GSocketAddressEnumerator
|
|
to list each #GSocketAddress which could be used to connect to that
|
|
#GSocketConnectable.
|
|
|
|
Enumeration is typically a blocking operation, so the asynchronous methods
|
|
g_socket_address_enumerator_next_async() and
|
|
g_socket_address_enumerator_next_finish() should be used where possible.
|
|
|
|
Each #GSocketAddressEnumerator can only be enumerated once. Once
|
|
g_socket_address_enumerator_next() has returned %NULL (and no error), further
|
|
enumeration with that #GSocketAddressEnumerator is not possible, and it can
|
|
be unreffed.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="78"/>
|
|
<virtual-method name="next" invoker="next" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34198">Retrieves the next #GSocketAddress from @enumerator. Note that this
|
|
may block for some amount of time. (Eg, a #GNetworkAddress may need
|
|
to do a DNS lookup before it can return an address.) Use
|
|
g_socket_address_enumerator_next_async() if you need to avoid
|
|
blocking.
|
|
|
|
If @enumerator is expected to yield addresses, but for some reason
|
|
is unable to (eg, because of a DNS error), then the first call to
|
|
g_socket_address_enumerator_next() will return an appropriate error
|
|
in *@error. However, if the first call to
|
|
g_socket_address_enumerator_next() succeeds, then any further
|
|
internal errors (other than @cancellable being triggered) will be
|
|
ignored.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34218">a #GSocketAddress (owned by the caller), or %NULL on
|
|
error (in which case *@error will be set) or if there are no
|
|
more addresses.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34200">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34201">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="next_async" invoker="next_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34224">Asynchronously retrieves the next #GSocketAddress from @enumerator
|
|
and then calls @callback, which must call
|
|
g_socket_address_enumerator_next_finish() to get the result.
|
|
|
|
It is an error to call this multiple times before the previous callback has finished.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34226">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34227">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34228">a #GAsyncReadyCallback to call when the request
|
|
is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34230">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="next_finish" invoker="next_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34240">Retrieves the result of a completed call to
|
|
g_socket_address_enumerator_next_async(). See
|
|
g_socket_address_enumerator_next() for more information about
|
|
error handling.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="75"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34251">a #GSocketAddress (owned by the caller), or %NULL on
|
|
error (in which case *@error will be set) or if there are no
|
|
more addresses.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34242">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34243">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="next" c:identifier="g_socket_address_enumerator_next" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34198">Retrieves the next #GSocketAddress from @enumerator. Note that this
|
|
may block for some amount of time. (Eg, a #GNetworkAddress may need
|
|
to do a DNS lookup before it can return an address.) Use
|
|
g_socket_address_enumerator_next_async() if you need to avoid
|
|
blocking.
|
|
|
|
If @enumerator is expected to yield addresses, but for some reason
|
|
is unable to (eg, because of a DNS error), then the first call to
|
|
g_socket_address_enumerator_next() will return an appropriate error
|
|
in *@error. However, if the first call to
|
|
g_socket_address_enumerator_next() succeeds, then any further
|
|
internal errors (other than @cancellable being triggered) will be
|
|
ignored.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="84"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34218">a #GSocketAddress (owned by the caller), or %NULL on
|
|
error (in which case *@error will be set) or if there are no
|
|
more addresses.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34200">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34201">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="next_async" c:identifier="g_socket_address_enumerator_next_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34224">Asynchronously retrieves the next #GSocketAddress from @enumerator
|
|
and then calls @callback, which must call
|
|
g_socket_address_enumerator_next_finish() to get the result.
|
|
|
|
It is an error to call this multiple times before the previous callback has finished.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34226">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34227">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34228">a #GAsyncReadyCallback to call when the request
|
|
is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34230">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="next_finish" c:identifier="g_socket_address_enumerator_next_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34240">Retrieves the result of a completed call to
|
|
g_socket_address_enumerator_next_async(). See
|
|
g_socket_address_enumerator_next() for more information about
|
|
error handling.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="94"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34251">a #GSocketAddress (owned by the caller), or %NULL on
|
|
error (in which case *@error will be set) or if there are no
|
|
more addresses.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34242">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34243">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
</class>
|
|
<record name="SocketAddressEnumeratorClass" c:type="GSocketAddressEnumeratorClass" glib:is-gtype-struct-for="SocketAddressEnumerator">
|
|
<doc xml:space="preserve" filename="gsocketaddressenumerator.h" line="51">Class structure for #GSocketAddressEnumerator.</doc>
|
|
<source-position filename="gsocketaddressenumerator.h" line="78"/>
|
|
<field name="parent_class" readable="0" private="1">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="next">
|
|
<callback name="next" throws="1">
|
|
<source-position filename="gsocketaddressenumerator.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34218">a #GSocketAddress (owned by the caller), or %NULL on
|
|
error (in which case *@error will be set) or if there are no
|
|
more addresses.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34200">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34201">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="next_async">
|
|
<callback name="next_async">
|
|
<source-position filename="gsocketaddressenumerator.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34226">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34227">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34228">a #GAsyncReadyCallback to call when the request
|
|
is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34230">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="next_finish">
|
|
<callback name="next_finish" throws="1">
|
|
<source-position filename="gsocketaddressenumerator.h" line="75"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34251">a #GSocketAddress (owned by the caller), or %NULL on
|
|
error (in which case *@error will be set) or if there are no
|
|
more addresses.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="enumerator" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34242">a #GSocketAddressEnumerator</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34243">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="SocketClass" c:type="GSocketClass" glib:is-gtype-struct-for="Socket">
|
|
<source-position filename="gsocket.h" line="66"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gsocket.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gsocket.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gsocket.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gsocket.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gsocket.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gsocket.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved7" introspectable="0">
|
|
<callback name="_g_reserved7">
|
|
<source-position filename="gsocket.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved8" introspectable="0">
|
|
<callback name="_g_reserved8">
|
|
<source-position filename="gsocket.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved9" introspectable="0">
|
|
<callback name="_g_reserved9">
|
|
<source-position filename="gsocket.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved10" introspectable="0">
|
|
<callback name="_g_reserved10">
|
|
<source-position filename="gsocket.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="SocketClient" c:symbol-prefix="socket_client" c:type="GSocketClient" version="2.22" parent="GObject.Object" glib:type-name="GSocketClient" glib:get-type="g_socket_client_get_type" glib:type-struct="SocketClientClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8399">#GSocketClient is a lightweight high-level utility class for connecting to
|
|
a network host using a connection oriented socket type.
|
|
|
|
You create a #GSocketClient object, set any options you want, and then
|
|
call a sync or async connect operation, which returns a #GSocketConnection
|
|
subclass on success.
|
|
|
|
The type of the #GSocketConnection object returned depends on the type of
|
|
the underlying socket that is in use. For instance, for a TCP/IP connection
|
|
it will be a #GTcpConnection.
|
|
|
|
As #GSocketClient is a lightweight object, you don't need to cache it. You
|
|
can just create a new one any time you need one.</doc>
|
|
<source-position filename="gsocketclient.h" line="63"/>
|
|
<constructor name="new" c:identifier="g_socket_client_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34773">Creates a new #GSocketClient with the default options.</doc>
|
|
<source-position filename="gsocketclient.h" line="75"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34778">a #GSocketClient.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<virtual-method name="event">
|
|
<source-position filename="gsocketclient.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="SocketClientEvent" c:type="GSocketClientEvent"/>
|
|
</parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="add_application_proxy" c:identifier="g_socket_client_add_application_proxy">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34367">Enable proxy protocols to be handled by the application. When the
|
|
indicated proxy protocol is returned by the #GProxyResolver,
|
|
#GSocketClient will consider this protocol as supported but will
|
|
not try to find a #GProxy instance to handle handshaking. The
|
|
application must check for this case by calling
|
|
g_socket_connection_get_remote_address() on the returned
|
|
#GSocketConnection, and seeing if it's a #GProxyAddress of the
|
|
appropriate type, to determine whether or not it needs to handle
|
|
the proxy handshaking itself.
|
|
|
|
This should be used for proxy protocols that are dialects of
|
|
another protocol such as HTTP proxy. It also allows cohabitation of
|
|
proxy protocols that are reused between protocols. A good example
|
|
is HTTP. It can be used to proxy HTTP, FTP and Gopher and can also
|
|
be use as generic socket proxy through the HTTP CONNECT method.
|
|
|
|
When the proxy is detected as being an application proxy, TLS handshake
|
|
will be skipped. This is required to let the application do the proxy
|
|
specific handshake.</doc>
|
|
<source-position filename="gsocketclient.h" line="192"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34369">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34370">The proxy protocol</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect" c:identifier="g_socket_client_connect" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34394">Tries to resolve the @connectable and make a network connection to it.
|
|
|
|
Upon a successful connection, a new #GSocketConnection is constructed
|
|
and returned. The caller owns this new object and must drop their
|
|
reference to it when finished with it.
|
|
|
|
The type of the #GSocketConnection object returned depends on the type of
|
|
the underlying socket that is used. For instance, for a TCP/IP connection
|
|
it will be a #GTcpConnection.
|
|
|
|
The socket created will be the same family as the address that the
|
|
@connectable resolves to, unless family is set with g_socket_client_set_family()
|
|
or indirectly via g_socket_client_set_local_address(). The socket type
|
|
defaults to %G_SOCKET_TYPE_STREAM but can be set with
|
|
g_socket_client_set_socket_type().
|
|
|
|
If a local address is specified with g_socket_client_set_local_address() the
|
|
socket will be bound to this address before connecting.</doc>
|
|
<source-position filename="gsocketclient.h" line="125"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34420">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34396">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34397">a #GSocketConnectable specifying the remote address.</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34398">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_async" c:identifier="g_socket_client_connect_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34425">This is the asynchronous version of g_socket_client_connect().
|
|
|
|
When the operation is finished @callback will be
|
|
called. You can then call g_socket_client_connect_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gsocketclient.h" line="148"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34427">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34428">a #GSocketConnectable specifying the remote address.</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34429">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34430">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34431">user data for the callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_finish" c:identifier="g_socket_client_connect_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34443">Finishes an async connect operation. See g_socket_client_connect_async()</doc>
|
|
<source-position filename="gsocketclient.h" line="154"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34452">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34445">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34446">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_host" c:identifier="g_socket_client_connect_to_host" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34457">This is a helper function for g_socket_client_connect().
|
|
|
|
Attempts to create a TCP connection to the named host.
|
|
|
|
@host_and_port may be in any of a number of recognized formats; an IPv6
|
|
address, an IPv4 address, or a domain name (in which case a DNS
|
|
lookup is performed). Quoting with [] is supported for all address
|
|
types. A port override may be specified in the usual way with a
|
|
colon. Ports may be given as decimal numbers or symbolic names (in
|
|
which case an /etc/services lookup is performed).
|
|
|
|
If no port override is given in @host_and_port then @default_port will be
|
|
used as the port number to connect to.
|
|
|
|
In general, @host_and_port is expected to be provided by the user (allowing
|
|
them to give the hostname, and a port override if necessary) and
|
|
@default_port is expected to be provided by the application.
|
|
|
|
In the case that an IP address is given, a single connection
|
|
attempt is made. In the case that a name is given, multiple
|
|
connection attempts may be made, in turn and according to the
|
|
number of address records in DNS, until a connection succeeds.
|
|
|
|
Upon a successful connection, a new #GSocketConnection is constructed
|
|
and returned. The caller owns this new object and must drop their
|
|
reference to it when finished with it.
|
|
|
|
In the event of any failure (DNS error, service not found, no hosts
|
|
connectable) %NULL is returned and @error (if non-%NULL) is set
|
|
accordingly.</doc>
|
|
<source-position filename="gsocketclient.h" line="130"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34496">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34459">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="host_and_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34460">the name and optionally port of the host to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34461">the default port to connect to</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34462">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_host_async" c:identifier="g_socket_client_connect_to_host_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34501">This is the asynchronous version of g_socket_client_connect_to_host().
|
|
|
|
When the operation is finished @callback will be
|
|
called. You can then call g_socket_client_connect_to_host_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gsocketclient.h" line="158"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34503">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="host_and_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34504">the name and optionally the port of the host to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34505">the default port to connect to</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34506">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34507">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34508">user data for the callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_host_finish" c:identifier="g_socket_client_connect_to_host_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34520">Finishes an async connect operation. See g_socket_client_connect_to_host_async()</doc>
|
|
<source-position filename="gsocketclient.h" line="165"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34529">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34522">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34523">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_service" c:identifier="g_socket_client_connect_to_service" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34534">Attempts to create a TCP connection to a service.
|
|
|
|
This call looks up the SRV record for @service at @domain for the
|
|
"tcp" protocol. It then attempts to connect, in turn, to each of
|
|
the hosts providing the service until either a connection succeeds
|
|
or there are no hosts remaining.
|
|
|
|
Upon a successful connection, a new #GSocketConnection is constructed
|
|
and returned. The caller owns this new object and must drop their
|
|
reference to it when finished with it.
|
|
|
|
In the event of any failure (DNS error, service not found, no hosts
|
|
connectable) %NULL is returned and @error (if non-%NULL) is set
|
|
accordingly.</doc>
|
|
<source-position filename="gsocketclient.h" line="136"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34557">a #GSocketConnection if successful, or %NULL on error</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34536">a #GSocketConnection</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34537">a domain name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34538">the name of the service to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34539">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_service_async" c:identifier="g_socket_client_connect_to_service_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34561">This is the asynchronous version of
|
|
g_socket_client_connect_to_service().</doc>
|
|
<source-position filename="gsocketclient.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34563">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34564">a domain name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34565">the name of the service to connect to</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34566">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34567">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34568">user data for the callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_service_finish" c:identifier="g_socket_client_connect_to_service_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34577">Finishes an async connect operation. See g_socket_client_connect_to_service_async()</doc>
|
|
<source-position filename="gsocketclient.h" line="177"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34586">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34579">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34580">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_uri" c:identifier="g_socket_client_connect_to_uri" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34591">This is a helper function for g_socket_client_connect().
|
|
|
|
Attempts to create a TCP connection with a network URI.
|
|
|
|
@uri may be any valid URI containing an "authority" (hostname/port)
|
|
component. If a port is not specified in the URI, @default_port
|
|
will be used. TLS will be negotiated if #GSocketClient:tls is %TRUE.
|
|
(#GSocketClient does not know to automatically assume TLS for
|
|
certain URI schemes.)
|
|
|
|
Using this rather than g_socket_client_connect() or
|
|
g_socket_client_connect_to_host() allows #GSocketClient to
|
|
determine when to use application-specific proxy protocols.
|
|
|
|
Upon a successful connection, a new #GSocketConnection is constructed
|
|
and returned. The caller owns this new object and must drop their
|
|
reference to it when finished with it.
|
|
|
|
In the event of any failure (DNS error, service not found, no hosts
|
|
connectable) %NULL is returned and @error (if non-%NULL) is set
|
|
accordingly.</doc>
|
|
<source-position filename="gsocketclient.h" line="142"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34621">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34593">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34594">A network URI</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34595">the default port to connect to</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34596">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_uri_async" c:identifier="g_socket_client_connect_to_uri_async" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34626">This is the asynchronous version of g_socket_client_connect_to_uri().
|
|
|
|
When the operation is finished @callback will be
|
|
called. You can then call g_socket_client_connect_to_uri_finish() to get
|
|
the result of the operation.</doc>
|
|
<source-position filename="gsocketclient.h" line="181"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34628">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34629">a network uri</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="default_port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34630">the default port to connect to</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34631">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34632">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34633">user data for the callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_to_uri_finish" c:identifier="g_socket_client_connect_to_uri_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34645">Finishes an async connect operation. See g_socket_client_connect_to_uri_async()</doc>
|
|
<source-position filename="gsocketclient.h" line="188"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34654">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34647">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34648">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_enable_proxy" c:identifier="g_socket_client_get_enable_proxy" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34659">Gets the proxy enable state; see g_socket_client_set_enable_proxy()</doc>
|
|
<source-position filename="gsocketclient.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34665">whether proxying is enabled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34661">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_family" c:identifier="g_socket_client_get_family" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34670">Gets the socket family of the socket client.
|
|
|
|
See g_socket_client_set_family() for details.</doc>
|
|
<source-position filename="gsocketclient.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34678">a #GSocketFamily</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34672">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_local_address" c:identifier="g_socket_client_get_local_address" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34683">Gets the local address of the socket client.
|
|
|
|
See g_socket_client_set_local_address() for details.</doc>
|
|
<source-position filename="gsocketclient.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34691">a #GSocketAddress or %NULL. Do not free.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34685">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_protocol" c:identifier="g_socket_client_get_protocol" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34696">Gets the protocol name type of the socket client.
|
|
|
|
See g_socket_client_set_protocol() for details.</doc>
|
|
<source-position filename="gsocketclient.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34704">a #GSocketProtocol</doc>
|
|
<type name="SocketProtocol" c:type="GSocketProtocol"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34698">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_proxy_resolver" c:identifier="g_socket_client_get_proxy_resolver" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34709">Gets the #GProxyResolver being used by @client. Normally, this will
|
|
be the resolver returned by g_proxy_resolver_get_default(), but you
|
|
can override it with g_socket_client_set_proxy_resolver().</doc>
|
|
<source-position filename="gsocketclient.h" line="119"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34717">The #GProxyResolver being used by
|
|
@client.</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34711">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_socket_type" c:identifier="g_socket_client_get_socket_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34723">Gets the socket type of the socket client.
|
|
|
|
See g_socket_client_set_socket_type() for details.</doc>
|
|
<source-position filename="gsocketclient.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34731">a #GSocketFamily</doc>
|
|
<type name="SocketType" c:type="GSocketType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34725">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_timeout" c:identifier="g_socket_client_get_timeout" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34736">Gets the I/O timeout time for sockets created by @client.
|
|
|
|
See g_socket_client_set_timeout() for details.</doc>
|
|
<source-position filename="gsocketclient.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34744">the timeout in seconds</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34738">a #GSocketClient</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_tls" c:identifier="g_socket_client_get_tls" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34749">Gets whether @client creates TLS connections. See
|
|
g_socket_client_set_tls() for details.</doc>
|
|
<source-position filename="gsocketclient.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34756">whether @client uses TLS</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34751">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_tls_validation_flags" c:identifier="g_socket_client_get_tls_validation_flags" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34761">Gets the TLS validation flags used creating TLS connections via
|
|
@client.</doc>
|
|
<source-position filename="gsocketclient.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34768">the TLS validation flags</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34763">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_enable_proxy" c:identifier="g_socket_client_set_enable_proxy" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34784">Sets whether or not @client attempts to make connections via a
|
|
proxy server. When enabled (the default), #GSocketClient will use a
|
|
#GProxyResolver to determine if a proxy protocol such as SOCKS is
|
|
needed, and automatically do the necessary proxy negotiation.
|
|
|
|
See also g_socket_client_set_proxy_resolver().</doc>
|
|
<source-position filename="gsocketclient.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34786">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="enable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34787">whether to enable proxies</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_family" c:identifier="g_socket_client_set_family" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34800">Sets the socket family of the socket client.
|
|
If this is set to something other than %G_SOCKET_FAMILY_INVALID
|
|
then the sockets created by this object will be of the specified
|
|
family.
|
|
|
|
This might be useful for instance if you want to force the local
|
|
connection to be an ipv4 socket, even though the address might
|
|
be an ipv6 mapped to ipv4 address.</doc>
|
|
<source-position filename="gsocketclient.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34802">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="family" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34803">a #GSocketFamily</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_local_address" c:identifier="g_socket_client_set_local_address" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34818">Sets the local address of the socket client.
|
|
The sockets created by this object will bound to the
|
|
specified address (if not %NULL) before connecting.
|
|
|
|
This is useful if you want to ensure that the local
|
|
side of the connection is on a specific port, or on
|
|
a specific interface.</doc>
|
|
<source-position filename="gsocketclient.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34820">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34821">a #GSocketAddress, or %NULL</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_protocol" c:identifier="g_socket_client_set_protocol" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34835">Sets the protocol of the socket client.
|
|
The sockets created by this object will use of the specified
|
|
protocol.
|
|
|
|
If @protocol is %G_SOCKET_PROTOCOL_DEFAULT that means to use the default
|
|
protocol for the socket family and type.</doc>
|
|
<source-position filename="gsocketclient.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34837">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34838">a #GSocketProtocol</doc>
|
|
<type name="SocketProtocol" c:type="GSocketProtocol"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_proxy_resolver" c:identifier="g_socket_client_set_proxy_resolver" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34851">Overrides the #GProxyResolver used by @client. You can call this if
|
|
you want to use specific proxies, rather than using the system
|
|
default proxy settings.
|
|
|
|
Note that whether or not the proxy resolver is actually used
|
|
depends on the setting of #GSocketClient:enable-proxy, which is not
|
|
changed by this function (but which is %TRUE by default)</doc>
|
|
<source-position filename="gsocketclient.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34853">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="proxy_resolver" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34854">a #GProxyResolver, or %NULL for the
|
|
default.</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_socket_type" c:identifier="g_socket_client_set_socket_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34869">Sets the socket type of the socket client.
|
|
The sockets created by this object will be of the specified
|
|
type.
|
|
|
|
It doesn't make sense to specify a type of %G_SOCKET_TYPE_DATAGRAM,
|
|
as GSocketClient is used for connection oriented services.</doc>
|
|
<source-position filename="gsocketclient.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34871">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34872">a #GSocketType</doc>
|
|
<type name="SocketType" c:type="GSocketType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_timeout" c:identifier="g_socket_client_set_timeout" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34885">Sets the I/O timeout for sockets created by @client. @timeout is a
|
|
time in seconds, or 0 for no timeout (the default).
|
|
|
|
The timeout value affects the initial connection attempt as well,
|
|
so setting this may cause calls to g_socket_client_connect(), etc,
|
|
to fail with %G_IO_ERROR_TIMED_OUT.</doc>
|
|
<source-position filename="gsocketclient.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34887">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="timeout" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34888">the timeout</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_tls" c:identifier="g_socket_client_set_tls" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34901">Sets whether @client creates TLS (aka SSL) connections. If @tls is
|
|
%TRUE, @client will wrap its connections in a #GTlsClientConnection
|
|
and perform a TLS handshake when connecting.
|
|
|
|
Note that since #GSocketClient must return a #GSocketConnection,
|
|
but #GTlsClientConnection is not a #GSocketConnection, this
|
|
actually wraps the resulting #GTlsClientConnection in a
|
|
#GTcpWrapperConnection when returning it. You can use
|
|
g_tcp_wrapper_connection_get_base_io_stream() on the return value
|
|
to extract the #GTlsClientConnection.
|
|
|
|
If you need to modify the behavior of the TLS handshake (eg, by
|
|
setting a client-side certificate to use, or connecting to the
|
|
#GTlsConnection::accept-certificate signal), you can connect to
|
|
@client's #GSocketClient::event signal and wait for it to be
|
|
emitted with %G_SOCKET_CLIENT_TLS_HANDSHAKING, which will give you
|
|
a chance to see the #GTlsClientConnection before the handshake
|
|
starts.</doc>
|
|
<source-position filename="gsocketclient.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34903">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="tls" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34904">whether to use TLS</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_tls_validation_flags" c:identifier="g_socket_client_set_tls_validation_flags" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34929">Sets the TLS validation flags used when creating TLS connections
|
|
via @client. The default value is %G_TLS_CERTIFICATE_VALIDATE_ALL.</doc>
|
|
<source-position filename="gsocketclient.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="client" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34931">a #GSocketClient.</doc>
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="34932">the validation flags</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="enable-proxy" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="family" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="SocketFamily"/>
|
|
</property>
|
|
<property name="local-address" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="SocketAddress"/>
|
|
</property>
|
|
<property name="protocol" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="SocketProtocol"/>
|
|
</property>
|
|
<property name="proxy-resolver" version="2.36" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3345">The proxy resolver to use</doc>
|
|
<type name="ProxyResolver"/>
|
|
</property>
|
|
<property name="timeout" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="guint" c:type="guint"/>
|
|
</property>
|
|
<property name="tls" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="tls-validation-flags" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="TlsCertificateFlags"/>
|
|
</property>
|
|
<property name="type" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="SocketType"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="SocketClientPrivate" c:type="GSocketClientPrivate*"/>
|
|
</field>
|
|
<glib:signal name="event" when="last" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3284">Emitted when @client's activity on @connectable changes state.
|
|
Among other things, this can be used to provide progress
|
|
information about a network connection in the UI. The meanings of
|
|
the different @event values are as follows:
|
|
|
|
- %G_SOCKET_CLIENT_RESOLVING: @client is about to look up @connectable
|
|
in DNS. @connection will be %NULL.
|
|
|
|
- %G_SOCKET_CLIENT_RESOLVED: @client has successfully resolved
|
|
@connectable in DNS. @connection will be %NULL.
|
|
|
|
- %G_SOCKET_CLIENT_CONNECTING: @client is about to make a connection
|
|
to a remote host; either a proxy server or the destination server
|
|
itself. @connection is the #GSocketConnection, which is not yet
|
|
connected. Since GLib 2.40, you can access the remote
|
|
address via g_socket_connection_get_remote_address().
|
|
|
|
- %G_SOCKET_CLIENT_CONNECTED: @client has successfully connected
|
|
to a remote host. @connection is the connected #GSocketConnection.
|
|
|
|
- %G_SOCKET_CLIENT_PROXY_NEGOTIATING: @client is about to negotiate
|
|
with a proxy to get it to connect to @connectable. @connection is
|
|
the #GSocketConnection to the proxy server.
|
|
|
|
- %G_SOCKET_CLIENT_PROXY_NEGOTIATED: @client has negotiated a
|
|
connection to @connectable through a proxy server. @connection is
|
|
the stream returned from g_proxy_connect(), which may or may not
|
|
be a #GSocketConnection.
|
|
|
|
- %G_SOCKET_CLIENT_TLS_HANDSHAKING: @client is about to begin a TLS
|
|
handshake. @connection is a #GTlsClientConnection.
|
|
|
|
- %G_SOCKET_CLIENT_TLS_HANDSHAKED: @client has successfully completed
|
|
the TLS handshake. @connection is a #GTlsClientConnection.
|
|
|
|
- %G_SOCKET_CLIENT_COMPLETE: @client has either successfully connected
|
|
to @connectable (in which case @connection is the #GSocketConnection
|
|
that it will be returning to the caller) or has failed (in which
|
|
case @connection is %NULL and the client is about to return an error).
|
|
|
|
Each event except %G_SOCKET_CLIENT_COMPLETE may be emitted
|
|
multiple times (or not at all) for a given connectable (in
|
|
particular, if @client ends up attempting to connect to more than
|
|
one address). However, if @client emits the #GSocketClient::event
|
|
signal at all for a given connectable, that it will always emit
|
|
it with %G_SOCKET_CLIENT_COMPLETE when it is done.
|
|
|
|
Note that there may be additional #GSocketClientEvent values in
|
|
the future; unrecognized @event values should be ignored.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3287">the event that is occurring</doc>
|
|
<type name="SocketClientEvent"/>
|
|
</parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3288">the #GSocketConnectable that @event is occurring on</doc>
|
|
<type name="SocketConnectable"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3289">the current representation of the connection</doc>
|
|
<type name="IOStream"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="SocketClientClass" c:type="GSocketClientClass" glib:is-gtype-struct-for="SocketClient">
|
|
<source-position filename="gsocketclient.h" line="63"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="event">
|
|
<callback name="event">
|
|
<source-position filename="gsocketclient.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="client" transfer-ownership="none">
|
|
<type name="SocketClient" c:type="GSocketClient*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="SocketClientEvent" c:type="GSocketClientEvent"/>
|
|
</parameter>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gsocketclient.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gsocketclient.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gsocketclient.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gsocketclient.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<enumeration name="SocketClientEvent" version="2.32" glib:type-name="GSocketClientEvent" glib:get-type="g_socket_client_event_get_type" c:type="GSocketClientEvent">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1770">Describes an event occurring on a #GSocketClient. See the
|
|
#GSocketClient::event signal for more details.
|
|
|
|
Additional values may be added to this type in the future.</doc>
|
|
<member name="resolving" value="0" c:identifier="G_SOCKET_CLIENT_RESOLVING" glib:nick="resolving">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1772">The client is doing a DNS lookup.</doc>
|
|
</member>
|
|
<member name="resolved" value="1" c:identifier="G_SOCKET_CLIENT_RESOLVED" glib:nick="resolved">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1773">The client has completed a DNS lookup.</doc>
|
|
</member>
|
|
<member name="connecting" value="2" c:identifier="G_SOCKET_CLIENT_CONNECTING" glib:nick="connecting">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1774">The client is connecting to a remote
|
|
host (either a proxy or the destination server).</doc>
|
|
</member>
|
|
<member name="connected" value="3" c:identifier="G_SOCKET_CLIENT_CONNECTED" glib:nick="connected">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1776">The client has connected to a remote
|
|
host.</doc>
|
|
</member>
|
|
<member name="proxy_negotiating" value="4" c:identifier="G_SOCKET_CLIENT_PROXY_NEGOTIATING" glib:nick="proxy-negotiating">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1778">The client is negotiating
|
|
with a proxy to connect to the destination server.</doc>
|
|
</member>
|
|
<member name="proxy_negotiated" value="5" c:identifier="G_SOCKET_CLIENT_PROXY_NEGOTIATED" glib:nick="proxy-negotiated">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1780">The client has negotiated
|
|
with the proxy server.</doc>
|
|
</member>
|
|
<member name="tls_handshaking" value="6" c:identifier="G_SOCKET_CLIENT_TLS_HANDSHAKING" glib:nick="tls-handshaking">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1782">The client is performing a
|
|
TLS handshake.</doc>
|
|
</member>
|
|
<member name="tls_handshaked" value="7" c:identifier="G_SOCKET_CLIENT_TLS_HANDSHAKED" glib:nick="tls-handshaked">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1784">The client has performed a
|
|
TLS handshake.</doc>
|
|
</member>
|
|
<member name="complete" value="8" c:identifier="G_SOCKET_CLIENT_COMPLETE" glib:nick="complete">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1786">The client is done with a particular
|
|
#GSocketConnectable.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="SocketClientPrivate" c:type="GSocketClientPrivate" disguised="1">
|
|
<source-position filename="gsocketclient.h" line="46"/>
|
|
</record>
|
|
<interface name="SocketConnectable" c:symbol-prefix="socket_connectable" c:type="GSocketConnectable" glib:type-name="GSocketConnectable" glib:get-type="g_socket_connectable_get_type" glib:type-struct="SocketConnectableIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8423">Objects that describe one or more potential socket endpoints
|
|
implement #GSocketConnectable. Callers can then use
|
|
g_socket_connectable_enumerate() to get a #GSocketAddressEnumerator
|
|
to try out each socket address in turn until one succeeds, as shown
|
|
in the sample code below.
|
|
|
|
|[<!-- language="C" -->
|
|
MyConnectionType *
|
|
connect_to_host (const char *hostname,
|
|
guint16 port,
|
|
GCancellable *cancellable,
|
|
GError **error)
|
|
{
|
|
MyConnection *conn = NULL;
|
|
GSocketConnectable *addr;
|
|
GSocketAddressEnumerator *enumerator;
|
|
GSocketAddress *sockaddr;
|
|
GError *conn_error = NULL;
|
|
|
|
addr = g_network_address_new (hostname, port);
|
|
enumerator = g_socket_connectable_enumerate (addr);
|
|
g_object_unref (addr);
|
|
|
|
// Try each sockaddr until we succeed. Record the first connection error,
|
|
// but not any further ones (since they'll probably be basically the same
|
|
// as the first).
|
|
while (!conn && (sockaddr = g_socket_address_enumerator_next (enumerator, cancellable, error))
|
|
{
|
|
conn = connect_to_sockaddr (sockaddr, conn_error ? NULL : &conn_error);
|
|
g_object_unref (sockaddr);
|
|
}
|
|
g_object_unref (enumerator);
|
|
|
|
if (conn)
|
|
{
|
|
if (conn_error)
|
|
{
|
|
// We couldn't connect to the first address, but we succeeded
|
|
// in connecting to a later address.
|
|
g_error_free (conn_error);
|
|
}
|
|
return conn;
|
|
}
|
|
else if (error)
|
|
{
|
|
/// Either initial lookup failed, or else the caller cancelled us.
|
|
if (conn_error)
|
|
g_error_free (conn_error);
|
|
return NULL;
|
|
}
|
|
else
|
|
{
|
|
g_error_propagate (error, conn_error);
|
|
return NULL;
|
|
}
|
|
}
|
|
]|</doc>
|
|
<source-position filename="gsocketconnectable.h" line="64"/>
|
|
<virtual-method name="enumerate" invoker="enumerate" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35091">Creates a #GSocketAddressEnumerator for @connectable.</doc>
|
|
<source-position filename="gsocketconnectable.h" line="59"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35097">a new #GSocketAddressEnumerator.</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35093">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="proxy_enumerate" invoker="proxy_enumerate" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35102">Creates a #GSocketAddressEnumerator for @connectable that will
|
|
return a #GProxyAddress for each of its addresses that you must connect
|
|
to via a proxy.
|
|
|
|
If @connectable does not implement
|
|
g_socket_connectable_proxy_enumerate(), this will fall back to
|
|
calling g_socket_connectable_enumerate().</doc>
|
|
<source-position filename="gsocketconnectable.h" line="61"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35114">a new #GSocketAddressEnumerator.</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35104">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="to_string" invoker="to_string" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35119">Format a #GSocketConnectable as a string. This is a human-readable format for
|
|
use in debugging output, and is not a stable serialization format. It is not
|
|
suitable for use in user interfaces as it exposes too much information for a
|
|
user.
|
|
|
|
If the #GSocketConnectable implementation does not support string formatting,
|
|
the implementation’s type name will be returned as a fallback.</doc>
|
|
<source-position filename="gsocketconnectable.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35131">the formatted string</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35121">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="enumerate" c:identifier="g_socket_connectable_enumerate" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35091">Creates a #GSocketAddressEnumerator for @connectable.</doc>
|
|
<source-position filename="gsocketconnectable.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35097">a new #GSocketAddressEnumerator.</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35093">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="proxy_enumerate" c:identifier="g_socket_connectable_proxy_enumerate" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35102">Creates a #GSocketAddressEnumerator for @connectable that will
|
|
return a #GProxyAddress for each of its addresses that you must connect
|
|
to via a proxy.
|
|
|
|
If @connectable does not implement
|
|
g_socket_connectable_proxy_enumerate(), this will fall back to
|
|
calling g_socket_connectable_enumerate().</doc>
|
|
<source-position filename="gsocketconnectable.h" line="73"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35114">a new #GSocketAddressEnumerator.</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35104">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="to_string" c:identifier="g_socket_connectable_to_string" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35119">Format a #GSocketConnectable as a string. This is a human-readable format for
|
|
use in debugging output, and is not a stable serialization format. It is not
|
|
suitable for use in user interfaces as it exposes too much information for a
|
|
user.
|
|
|
|
If the #GSocketConnectable implementation does not support string formatting,
|
|
the implementation’s type name will be returned as a fallback.</doc>
|
|
<source-position filename="gsocketconnectable.h" line="76"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35131">the formatted string</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35121">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="SocketConnectableIface" c:type="GSocketConnectableIface" glib:is-gtype-struct-for="SocketConnectable">
|
|
<doc xml:space="preserve" filename="gsocketconnectable.h" line="42">Provides an interface for returning a #GSocketAddressEnumerator
|
|
and #GProxyAddressEnumerator</doc>
|
|
<source-position filename="gsocketconnectable.h" line="64"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gsocketconnectable.h" line="44">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="enumerate">
|
|
<callback name="enumerate">
|
|
<source-position filename="gsocketconnectable.h" line="59"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35097">a new #GSocketAddressEnumerator.</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35093">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="proxy_enumerate">
|
|
<callback name="proxy_enumerate">
|
|
<source-position filename="gsocketconnectable.h" line="61"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35114">a new #GSocketAddressEnumerator.</doc>
|
|
<type name="SocketAddressEnumerator" c:type="GSocketAddressEnumerator*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35104">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="to_string">
|
|
<callback name="to_string">
|
|
<source-position filename="gsocketconnectable.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35131">the formatted string</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connectable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35121">a #GSocketConnectable</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="SocketConnection" c:symbol-prefix="socket_connection" c:type="GSocketConnection" version="2.22" parent="IOStream" glib:type-name="GSocketConnection" glib:get-type="g_socket_connection_get_type" glib:type-struct="SocketConnectionClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8488">#GSocketConnection is a #GIOStream for a connected socket. They
|
|
can be created either by #GSocketClient when connecting to a host,
|
|
or by #GSocketListener when accepting a new client.
|
|
|
|
The type of the #GSocketConnection object returned from these calls
|
|
depends on the type of the underlying socket that is in use. For
|
|
instance, for a TCP/IP connection it will be a #GTcpConnection.
|
|
|
|
Choosing what type of object to construct is done with the socket
|
|
connection factory, and it is possible for 3rd parties to register
|
|
custom socket connection types for specific combination of socket
|
|
family/type/protocol using g_socket_connection_factory_register_type().
|
|
|
|
To close a #GSocketConnection, use g_io_stream_close(). Closing both
|
|
substreams of the #GIOStream separately will not close the underlying
|
|
#GSocket.</doc>
|
|
<source-position filename="gsocketconnection.h" line="63"/>
|
|
<function name="factory_lookup_type" c:identifier="g_socket_connection_factory_lookup_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35194">Looks up the #GType to be used when creating socket connections on
|
|
sockets with the specified @family, @type and @protocol_id.
|
|
|
|
If no type is registered, the #GSocketConnection base type is returned.</doc>
|
|
<source-position filename="gsocketconnection.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35205">a #GType</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="family" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35196">a #GSocketFamily</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35197">a #GSocketType</doc>
|
|
<type name="SocketType" c:type="GSocketType"/>
|
|
</parameter>
|
|
<parameter name="protocol_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35198">a protocol id</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="factory_register_type" c:identifier="g_socket_connection_factory_register_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35210">Looks up the #GType to be used when creating socket connections on
|
|
sockets with the specified @family, @type and @protocol.
|
|
|
|
If no type is registered, the #GSocketConnection base type is returned.</doc>
|
|
<source-position filename="gsocketconnection.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="g_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35212">a #GType, inheriting from %G_TYPE_SOCKET_CONNECTION</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="family" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35213">a #GSocketFamily</doc>
|
|
<type name="SocketFamily" c:type="GSocketFamily"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35214">a #GSocketType</doc>
|
|
<type name="SocketType" c:type="GSocketType"/>
|
|
</parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35215">a protocol id</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="connect" c:identifier="g_socket_connection_connect" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35136">Connect @connection to the specified remote address.</doc>
|
|
<source-position filename="gsocketconnection.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35145">%TRUE if the connection succeeded, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35138">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35139">a #GSocketAddress specifying the remote address.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35140">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_async" c:identifier="g_socket_connection_connect_async" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35150">Asynchronously connect @connection to the specified remote address.
|
|
|
|
This clears the #GSocket:blocking flag on @connection's underlying
|
|
socket if it is currently set.
|
|
|
|
Use g_socket_connection_connect_finish() to retrieve the result.</doc>
|
|
<source-position filename="gsocketconnection.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35152">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35153">a #GSocketAddress specifying the remote address.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35154">a %GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35155">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35156">user data for the callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="connect_finish" c:identifier="g_socket_connection_connect_finish" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35169">Gets the result of a g_socket_connection_connect_async() call.</doc>
|
|
<source-position filename="gsocketconnection.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35177">%TRUE if the connection succeeded, %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35171">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35172">the #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_local_address" c:identifier="g_socket_connection_get_local_address" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35226">Try to get the local address of a socket connection.</doc>
|
|
<source-position filename="gsocketconnection.h" line="95"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35233">a #GSocketAddress or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35228">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_remote_address" c:identifier="g_socket_connection_get_remote_address" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35239">Try to get the remote address of a socket connection.
|
|
|
|
Since GLib 2.40, when used with g_socket_client_connect() or
|
|
g_socket_client_connect_async(), during emission of
|
|
%G_SOCKET_CLIENT_CONNECTING, this function will return the remote
|
|
address that will be used for the connection. This allows
|
|
applications to print e.g. "Connecting to example.com
|
|
(10.42.77.3)...".</doc>
|
|
<source-position filename="gsocketconnection.h" line="98"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35253">a #GSocketAddress or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35241">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_socket" c:identifier="g_socket_connection_get_socket" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35259">Gets the underlying #GSocket object of the connection.
|
|
This can be useful if you want to do something unusual on it
|
|
not supported by the #GSocketConnection APIs.</doc>
|
|
<source-position filename="gsocketconnection.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35267">a #GSocket or %NULL on error.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35261">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_connected" c:identifier="g_socket_connection_is_connected" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35272">Checks if @connection is connected. This is equivalent to calling
|
|
g_socket_is_connected() on @connection's underlying #GSocket.</doc>
|
|
<source-position filename="gsocketconnection.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35279">whether @connection is connected</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35274">a #GSocketConnection</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="socket" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="Socket"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="IOStream" c:type="GIOStream"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="SocketConnectionPrivate" c:type="GSocketConnectionPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="SocketConnectionClass" c:type="GSocketConnectionClass" glib:is-gtype-struct-for="SocketConnection">
|
|
<source-position filename="gsocketconnection.h" line="63"/>
|
|
<field name="parent_class">
|
|
<type name="IOStreamClass" c:type="GIOStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gsocketconnection.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gsocketconnection.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gsocketconnection.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gsocketconnection.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gsocketconnection.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gsocketconnection.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="SocketConnectionPrivate" c:type="GSocketConnectionPrivate" disguised="1">
|
|
<source-position filename="gsocketconnection.h" line="49"/>
|
|
</record>
|
|
<class name="SocketControlMessage" c:symbol-prefix="socket_control_message" c:type="GSocketControlMessage" version="2.22" parent="GObject.Object" abstract="1" glib:type-name="GSocketControlMessage" glib:get-type="g_socket_control_message_get_type" glib:type-struct="SocketControlMessageClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8515">A #GSocketControlMessage is a special-purpose utility message that
|
|
can be sent to or received from a #GSocket. These types of
|
|
messages are often called "ancillary data".
|
|
|
|
The message can represent some sort of special instruction to or
|
|
information from the socket or can represent a special kind of
|
|
transfer to the peer (for example, sending a file descriptor over
|
|
a UNIX socket).
|
|
|
|
These messages are sent with g_socket_send_message() and received
|
|
with g_socket_receive_message().
|
|
|
|
To extend the set of control message that can be sent, subclass this
|
|
class and override the get_size, get_level, get_type and serialize
|
|
methods.
|
|
|
|
To extend the set of control messages that can be received, subclass
|
|
this class and implement the deserialize method. Also, make sure your
|
|
class is registered with the GType typesystem before calling
|
|
g_socket_receive_message() to read such a message.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="83"/>
|
|
<function name="deserialize" c:identifier="g_socket_control_message_deserialize" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35284">Tries to deserialize a socket control message of a given
|
|
@level and @type. This will ask all known (to GType) subclasses
|
|
of #GSocketControlMessage if they can understand this kind
|
|
of message and if so deserialize it into a #GSocketControlMessage.
|
|
|
|
If there is no implementation for this kind of control message, %NULL
|
|
will be returned.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="103"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35299">the deserialized message or %NULL</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="level" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35286">a socket level</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35287">a socket control message type for the given @level</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35288">the size of the data in bytes</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35289">pointer to the message data</doc>
|
|
<array length="2" zero-terminated="0" c:type="gpointer">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="get_level" invoker="get_level" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35304">Returns the "level" (i.e. the originating protocol) of the control message.
|
|
This is often SOL_SOCKET.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35311">an integer describing the level</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35306">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_size" invoker="get_size" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35328">Returns the space required for the control message, not including
|
|
headers or alignment.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35335">The number of bytes required.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35330">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_type">
|
|
<source-position filename="gsocketcontrolmessage.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="serialize" invoker="serialize" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35340">Converts the data in the message to bytes placed in the
|
|
message.
|
|
|
|
@data is guaranteed to have enough space to fit the size
|
|
returned by g_socket_control_message_get_size() on this
|
|
object.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35342">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35343">A buffer to write data to</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_level" c:identifier="g_socket_control_message_get_level" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35304">Returns the "level" (i.e. the originating protocol) of the control message.
|
|
This is often SOL_SOCKET.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35311">an integer describing the level</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35306">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_msg_type" c:identifier="g_socket_control_message_get_msg_type" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35316">Returns the protocol specific type of the control message.
|
|
For instance, for UNIX fd passing this would be SCM_RIGHTS.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35323">an integer describing the type of control message</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35318">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_size" c:identifier="g_socket_control_message_get_size" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35328">Returns the space required for the control message, not including
|
|
headers or alignment.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35335">The number of bytes required.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35330">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="serialize" c:identifier="g_socket_control_message_serialize" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35340">Converts the data in the message to bytes placed in the
|
|
message.
|
|
|
|
@data is guaranteed to have enough space to fit the size
|
|
returned by g_socket_control_message_get_size() on this
|
|
object.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35342">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35343">A buffer to write data to</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="SocketControlMessagePrivate" c:type="GSocketControlMessagePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="SocketControlMessageClass" c:type="GSocketControlMessageClass" glib:is-gtype-struct-for="SocketControlMessage">
|
|
<doc xml:space="preserve" filename="gsocketcontrolmessage.h" line="50">Class structure for #GSocketControlMessage.</doc>
|
|
<source-position filename="gsocketcontrolmessage.h" line="83"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_size">
|
|
<callback name="get_size">
|
|
<source-position filename="gsocketcontrolmessage.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35335">The number of bytes required.</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35330">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_level">
|
|
<callback name="get_level">
|
|
<source-position filename="gsocketcontrolmessage.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35311">an integer describing the level</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35306">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_type">
|
|
<callback name="get_type">
|
|
<source-position filename="gsocketcontrolmessage.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gint" c:type="int"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="serialize">
|
|
<callback name="serialize">
|
|
<source-position filename="gsocketcontrolmessage.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35342">a #GSocketControlMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35343">A buffer to write data to</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="deserialize" introspectable="0">
|
|
<callback name="deserialize" introspectable="0">
|
|
<source-position filename="gsocketcontrolmessage.h" line="70"/>
|
|
<return-value>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="level" transfer-ownership="none">
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="size" transfer-ownership="none">
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gsocketcontrolmessage.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gsocketcontrolmessage.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gsocketcontrolmessage.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gsocketcontrolmessage.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gsocketcontrolmessage.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="SocketControlMessagePrivate" c:type="GSocketControlMessagePrivate" disguised="1">
|
|
<source-position filename="gsocketcontrolmessage.h" line="47"/>
|
|
</record>
|
|
<enumeration name="SocketFamily" version="2.22" glib:type-name="GSocketFamily" glib:get-type="g_socket_family_get_type" c:type="GSocketFamily">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="807">The protocol family of a #GSocketAddress. (These values are
|
|
identical to the system defines %AF_INET, %AF_INET6 and %AF_UNIX,
|
|
if available.)</doc>
|
|
<member name="invalid" value="0" c:identifier="G_SOCKET_FAMILY_INVALID" glib:nick="invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="809">no address family</doc>
|
|
</member>
|
|
<member name="unix" value="1" c:identifier="G_SOCKET_FAMILY_UNIX" glib:nick="unix">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="812">the UNIX domain family</doc>
|
|
</member>
|
|
<member name="ipv4" value="2" c:identifier="G_SOCKET_FAMILY_IPV4" glib:nick="ipv4">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="810">the IPv4 family</doc>
|
|
</member>
|
|
<member name="ipv6" value="10" c:identifier="G_SOCKET_FAMILY_IPV6" glib:nick="ipv6">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="811">the IPv6 family</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="SocketListener" c:symbol-prefix="socket_listener" c:type="GSocketListener" version="2.22" parent="GObject.Object" glib:type-name="GSocketListener" glib:get-type="g_socket_listener_get_type" glib:type-struct="SocketListenerClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8547">A #GSocketListener is an object that keeps track of a set
|
|
of server sockets and helps you accept sockets from any of the
|
|
socket, either sync or async.
|
|
|
|
Add addresses and ports to listen on using g_socket_listener_add_address()
|
|
and g_socket_listener_add_inet_port(). These will be listened on until
|
|
g_socket_listener_close() is called. Dropping your final reference to the
|
|
#GSocketListener will not cause g_socket_listener_close() to be called
|
|
implicitly, as some references to the #GSocketListener may be held
|
|
internally.
|
|
|
|
If you want to implement a network server, also look at #GSocketService
|
|
and #GThreadedSocketService which are subclasses of #GSocketListener
|
|
that make this even easier.</doc>
|
|
<source-position filename="gsocketlistener.h" line="74"/>
|
|
<constructor name="new" c:identifier="g_socket_listener_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36034">Creates a new #GSocketListener with no sockets to listen for.
|
|
New listeners can be added with e.g. g_socket_listener_add_address()
|
|
or g_socket_listener_add_inet_port().</doc>
|
|
<source-position filename="gsocketlistener.h" line="86"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36041">a new #GSocketListener.</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<virtual-method name="changed">
|
|
<source-position filename="gsocketlistener.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="event">
|
|
<source-position filename="gsocketlistener.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="SocketListenerEvent" c:type="GSocketListenerEvent"/>
|
|
</parameter>
|
|
<parameter name="socket" transfer-ownership="none">
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="accept" c:identifier="g_socket_listener_accept" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35796">Blocks waiting for a client to connect to any of the sockets added
|
|
to the listener. Returns a #GSocketConnection for the socket that was
|
|
accepted.
|
|
|
|
If @source_object is not %NULL it will be filled out with the source
|
|
object specified when the corresponding socket or address was added
|
|
to the listener.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gsocketlistener.h" line="133"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35815">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35798">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="source_object" direction="out" caller-allocates="0" transfer-ownership="none" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35799">location where #GObject pointer will be stored, or %NULL</doc>
|
|
<type name="GObject.Object" c:type="GObject**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35800">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="accept_async" c:identifier="g_socket_listener_accept_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35820">This is the asynchronous version of g_socket_listener_accept().
|
|
|
|
When the operation is finished @callback will be
|
|
called. You can then call g_socket_listener_accept_socket()
|
|
to get the result of the operation.</doc>
|
|
<source-position filename="gsocketlistener.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35822">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35823">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35824">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35825">user data for the callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="accept_finish" c:identifier="g_socket_listener_accept_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35837">Finishes an async accept operation. See g_socket_listener_accept_async()</doc>
|
|
<source-position filename="gsocketlistener.h" line="145"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35847">a #GSocketConnection on success, %NULL on error.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35839">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35840">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="source_object" direction="out" caller-allocates="0" transfer-ownership="none" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35841">Optional #GObject identifying this source</doc>
|
|
<type name="GObject.Object" c:type="GObject**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="accept_socket" c:identifier="g_socket_listener_accept_socket" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35852">Blocks waiting for a client to connect to any of the sockets added
|
|
to the listener. Returns the #GSocket that was accepted.
|
|
|
|
If you want to accept the high-level #GSocketConnection, not a #GSocket,
|
|
which is often the case, then you should use g_socket_listener_accept()
|
|
instead.
|
|
|
|
If @source_object is not %NULL it will be filled out with the source
|
|
object specified when the corresponding socket or address was added
|
|
to the listener.
|
|
|
|
If @cancellable is not %NULL, then the operation can be cancelled by
|
|
triggering the cancellable object from another thread. If the operation
|
|
was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.</doc>
|
|
<source-position filename="gsocketlistener.h" line="116"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35874">a #GSocket on success, %NULL on error.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35854">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="source_object" direction="out" caller-allocates="0" transfer-ownership="none" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35855">location where #GObject pointer will be stored, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="GObject**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35856">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="accept_socket_async" c:identifier="g_socket_listener_accept_socket_async" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35879">This is the asynchronous version of g_socket_listener_accept_socket().
|
|
|
|
When the operation is finished @callback will be
|
|
called. You can then call g_socket_listener_accept_socket_finish()
|
|
to get the result of the operation.</doc>
|
|
<source-position filename="gsocketlistener.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35881">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35882">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35883">a #GAsyncReadyCallback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35884">user data for the callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="accept_socket_finish" c:identifier="g_socket_listener_accept_socket_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35896">Finishes an async accept operation. See g_socket_listener_accept_socket_async()</doc>
|
|
<source-position filename="gsocketlistener.h" line="126"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35906">a #GSocket on success, %NULL on error.</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35898">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35899">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="source_object" direction="out" caller-allocates="0" transfer-ownership="none" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35900">Optional #GObject identifying this source</doc>
|
|
<type name="GObject.Object" c:type="GObject**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_address" c:identifier="g_socket_listener_add_address" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35911">Creates a socket of type @type and protocol @protocol, binds
|
|
it to @address and adds it to the set of sockets we're accepting
|
|
sockets from.
|
|
|
|
Note that adding an IPv6 address, depending on the platform,
|
|
may or may not result in a listener that also accepts IPv4
|
|
connections. For more deterministic behavior, see
|
|
g_socket_listener_add_inet_port().
|
|
|
|
@source_object will be passed out in the various calls
|
|
to accept to identify this particular source, which is
|
|
useful if you're listening on multiple addresses and do
|
|
different things depending on what address is connected to.
|
|
|
|
If successful and @effective_address is non-%NULL then it will
|
|
be set to the address that the binding actually occurred at. This
|
|
is helpful for determining the port number that was used for when
|
|
requesting a binding to port 0 (ie: "any port"). This address, if
|
|
requested, belongs to the caller and must be freed.
|
|
|
|
Call g_socket_listener_close() to stop listening on @address; this will not
|
|
be done automatically when you drop your final reference to @listener, as
|
|
references may be held internally.</doc>
|
|
<source-position filename="gsocketlistener.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35945">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35913">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35914">a #GSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35915">a #GSocketType</doc>
|
|
<type name="SocketType" c:type="GSocketType"/>
|
|
</parameter>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35916">a #GSocketProtocol</doc>
|
|
<type name="SocketProtocol" c:type="GSocketProtocol"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35917">Optional #GObject identifying this source</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="effective_address" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35918">location to store the address that was bound to, or %NULL.</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_any_inet_port" c:identifier="g_socket_listener_add_any_inet_port" version="2.24" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35950">Listens for TCP connections on any available port number for both
|
|
IPv6 and IPv4 (if each is available).
|
|
|
|
This is useful if you need to have a socket for incoming connections
|
|
but don't care about the specific port number.
|
|
|
|
@source_object will be passed out in the various calls
|
|
to accept to identify this particular source, which is
|
|
useful if you're listening on multiple addresses and do
|
|
different things depending on what address is connected to.</doc>
|
|
<source-position filename="gsocketlistener.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35968">the port number, or 0 in case of failure.</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35952">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35953">Optional #GObject identifying this source</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_inet_port" c:identifier="g_socket_listener_add_inet_port" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35973">Helper function for g_socket_listener_add_address() that
|
|
creates a TCP/IP socket listening on IPv4 and IPv6 (if
|
|
supported) on the specified port on all interfaces.
|
|
|
|
@source_object will be passed out in the various calls
|
|
to accept to identify this particular source, which is
|
|
useful if you're listening on multiple addresses and do
|
|
different things depending on what address is connected to.
|
|
|
|
Call g_socket_listener_close() to stop listening on @port; this will not
|
|
be done automatically when you drop your final reference to @listener, as
|
|
references may be held internally.</doc>
|
|
<source-position filename="gsocketlistener.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35993">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35975">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35976">an IP port number (non-zero)</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35977">Optional #GObject identifying this source</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="add_socket" c:identifier="g_socket_listener_add_socket" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="35998">Adds @socket to the set of sockets that we try to accept
|
|
new clients from. The socket must be bound to a local
|
|
address and listened to.
|
|
|
|
@source_object will be passed out in the various calls
|
|
to accept to identify this particular source, which is
|
|
useful if you're listening on multiple addresses and do
|
|
different things depending on what address is connected to.
|
|
|
|
The @socket will not be automatically closed when the @listener is finalized
|
|
unless the listener held the final reference to the socket. Before GLib 2.42,
|
|
the @socket was automatically closed on finalization of the @listener, even
|
|
if references to it were held elsewhere.</doc>
|
|
<source-position filename="gsocketlistener.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36019">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36000">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36001">a listening #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36002">Optional #GObject identifying this source</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="close" c:identifier="g_socket_listener_close" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36024">Closes all the sockets in the listener.</doc>
|
|
<source-position filename="gsocketlistener.h" line="151"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36026">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_backlog" c:identifier="g_socket_listener_set_backlog" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36046">Sets the listen backlog on the sockets in the listener. This must be called
|
|
before adding any sockets, addresses or ports to the #GSocketListener (for
|
|
example, by calling g_socket_listener_add_inet_port()) to be effective.
|
|
|
|
See g_socket_set_listen_backlog() for details</doc>
|
|
<source-position filename="gsocketlistener.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="listener" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36048">a #GSocketListener</doc>
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</instance-parameter>
|
|
<parameter name="listen_backlog" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36049">an integer</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="listen-backlog" writable="1" construct="1" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="SocketListenerPrivate" c:type="GSocketListenerPrivate*"/>
|
|
</field>
|
|
<glib:signal name="event" when="last" version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3354">Emitted when @listener's activity on @socket changes state.
|
|
Note that when @listener is used to listen on both IPv4 and
|
|
IPv6, a separate set of signals will be emitted for each, and
|
|
the order they happen in is undefined.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3357">the event that is occurring</doc>
|
|
<type name="SocketListenerEvent"/>
|
|
</parameter>
|
|
<parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3358">the #GSocket the event is occurring on</doc>
|
|
<type name="Socket"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="SocketListenerClass" c:type="GSocketListenerClass" glib:is-gtype-struct-for="SocketListener">
|
|
<doc xml:space="preserve" filename="gsocketlistener.h" line="52">Class structure for #GSocketListener.</doc>
|
|
<source-position filename="gsocketlistener.h" line="74"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="changed">
|
|
<callback name="changed">
|
|
<source-position filename="gsocketlistener.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="listener" transfer-ownership="none">
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="event">
|
|
<callback name="event">
|
|
<source-position filename="gsocketlistener.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="listener" transfer-ownership="none">
|
|
<type name="SocketListener" c:type="GSocketListener*"/>
|
|
</parameter>
|
|
<parameter name="event" transfer-ownership="none">
|
|
<type name="SocketListenerEvent" c:type="GSocketListenerEvent"/>
|
|
</parameter>
|
|
<parameter name="socket" transfer-ownership="none">
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gsocketlistener.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gsocketlistener.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gsocketlistener.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gsocketlistener.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gsocketlistener.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<enumeration name="SocketListenerEvent" version="2.46" glib:type-name="GSocketListenerEvent" glib:get-type="g_socket_listener_event_get_type" c:type="GSocketListenerEvent">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1808">Describes an event occurring on a #GSocketListener. See the
|
|
#GSocketListener::event signal for more details.
|
|
|
|
Additional values may be added to this type in the future.</doc>
|
|
<member name="binding" value="0" c:identifier="G_SOCKET_LISTENER_BINDING" glib:nick="binding">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1810">The listener is about to bind a socket.</doc>
|
|
</member>
|
|
<member name="bound" value="1" c:identifier="G_SOCKET_LISTENER_BOUND" glib:nick="bound">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1811">The listener has bound a socket.</doc>
|
|
</member>
|
|
<member name="listening" value="2" c:identifier="G_SOCKET_LISTENER_LISTENING" glib:nick="listening">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1812">The listener is about to start
|
|
listening on this socket.</doc>
|
|
</member>
|
|
<member name="listened" value="3" c:identifier="G_SOCKET_LISTENER_LISTENED" glib:nick="listened">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1814">The listener is now listening on
|
|
this socket.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="SocketListenerPrivate" c:type="GSocketListenerPrivate" disguised="1">
|
|
<source-position filename="gsocketlistener.h" line="49"/>
|
|
</record>
|
|
<bitfield name="SocketMsgFlags" version="2.22" glib:type-name="GSocketMsgFlags" glib:get-type="g_socket_msg_flags_get_type" c:type="GSocketMsgFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="849">Flags used in g_socket_receive_message() and g_socket_send_message().
|
|
The flags listed in the enum are some commonly available flags, but the
|
|
values used for them are the same as on the platform, and any other flags
|
|
are passed in/out as is. So to use a platform specific flag, just include
|
|
the right system header and pass in the flag.</doc>
|
|
<member name="none" value="0" c:identifier="G_SOCKET_MSG_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="851">No flags.</doc>
|
|
</member>
|
|
<member name="oob" value="1" c:identifier="G_SOCKET_MSG_OOB" glib:nick="oob">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="852">Request to send/receive out of band data.</doc>
|
|
</member>
|
|
<member name="peek" value="2" c:identifier="G_SOCKET_MSG_PEEK" glib:nick="peek">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="853">Read data from the socket without removing it from
|
|
the queue.</doc>
|
|
</member>
|
|
<member name="dontroute" value="4" c:identifier="G_SOCKET_MSG_DONTROUTE" glib:nick="dontroute">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="855">Don't use a gateway to send out the packet,
|
|
only send to hosts on directly connected networks.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="SocketPrivate" c:type="GSocketPrivate" disguised="1">
|
|
<source-position filename="gsocket.h" line="46"/>
|
|
</record>
|
|
<enumeration name="SocketProtocol" version="2.22" glib:type-name="GSocketProtocol" glib:get-type="g_socket_protocol_get_type" c:type="GSocketProtocol">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="874">A protocol identifier is specified when creating a #GSocket, which is a
|
|
family/type specific identifier, where 0 means the default protocol for
|
|
the particular family/type.
|
|
|
|
This enum contains a set of commonly available and used protocols. You
|
|
can also pass any other identifiers handled by the platform in order to
|
|
use protocols not listed here.</doc>
|
|
<member name="unknown" value="-1" c:identifier="G_SOCKET_PROTOCOL_UNKNOWN" glib:nick="unknown">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="876">The protocol type is unknown</doc>
|
|
</member>
|
|
<member name="default" value="0" c:identifier="G_SOCKET_PROTOCOL_DEFAULT" glib:nick="default">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="877">The default protocol for the family/type</doc>
|
|
</member>
|
|
<member name="tcp" value="6" c:identifier="G_SOCKET_PROTOCOL_TCP" glib:nick="tcp">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="878">TCP over IP</doc>
|
|
</member>
|
|
<member name="udp" value="17" c:identifier="G_SOCKET_PROTOCOL_UDP" glib:nick="udp">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="879">UDP over IP</doc>
|
|
</member>
|
|
<member name="sctp" value="132" c:identifier="G_SOCKET_PROTOCOL_SCTP" glib:nick="sctp">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="880">SCTP over IP</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="SocketService" c:symbol-prefix="socket_service" c:type="GSocketService" version="2.22" parent="SocketListener" glib:type-name="GSocketService" glib:get-type="g_socket_service_get_type" glib:type-struct="SocketServiceClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8573">A #GSocketService is an object that represents a service that
|
|
is provided to the network or over local sockets. When a new
|
|
connection is made to the service the #GSocketService::incoming
|
|
signal is emitted.
|
|
|
|
A #GSocketService is a subclass of #GSocketListener and you need
|
|
to add the addresses you want to accept connections on with the
|
|
#GSocketListener APIs.
|
|
|
|
There are two options for implementing a network service based on
|
|
#GSocketService. The first is to create the service using
|
|
g_socket_service_new() and to connect to the #GSocketService::incoming
|
|
signal. The second is to subclass #GSocketService and override the
|
|
default signal handler implementation.
|
|
|
|
In either case, the handler must immediately return, or else it
|
|
will block additional incoming connections from being serviced.
|
|
If you are interested in writing connection handlers that contain
|
|
blocking code then see #GThreadedSocketService.
|
|
|
|
The socket service runs on the main loop of the
|
|
[thread-default context][g-main-context-push-thread-default-context]
|
|
of the thread it is created in, and is not
|
|
threadsafe in general. However, the calls to start and stop the
|
|
service are thread-safe so these can be used from threads that
|
|
handle incoming clients.</doc>
|
|
<source-position filename="gsocketservice.h" line="70"/>
|
|
<constructor name="new" c:identifier="g_socket_service_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36577">Creates a new #GSocketService with no sockets to listen for.
|
|
New listeners can be added with e.g. g_socket_listener_add_address()
|
|
or g_socket_listener_add_inet_port().
|
|
|
|
New services are created active, there is no need to call
|
|
g_socket_service_start(), unless g_socket_service_stop() has been
|
|
called before.</doc>
|
|
<source-position filename="gsocketservice.h" line="82"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36588">a new #GSocketService.</doc>
|
|
<type name="SocketService" c:type="GSocketService*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<virtual-method name="incoming">
|
|
<source-position filename="gsocketservice.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="service" transfer-ownership="none">
|
|
<type name="SocketService" c:type="GSocketService*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none">
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="is_active" c:identifier="g_socket_service_is_active" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36563">Check whether the service is active or not. An active
|
|
service will accept new clients that connect, while
|
|
a non-active service will let connecting clients queue
|
|
up until the service is started.</doc>
|
|
<source-position filename="gsocketservice.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36572">%TRUE if the service is active, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36565">a #GSocketService</doc>
|
|
<type name="SocketService" c:type="GSocketService*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="start" c:identifier="g_socket_service_start" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36593">Restarts the service, i.e. start accepting connections
|
|
from the added sockets when the mainloop runs. This only needs
|
|
to be called after the service has been stopped from
|
|
g_socket_service_stop().
|
|
|
|
This call is thread-safe, so it may be called from a thread
|
|
handling an incoming client request.</doc>
|
|
<source-position filename="gsocketservice.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36595">a #GSocketService</doc>
|
|
<type name="SocketService" c:type="GSocketService*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop" c:identifier="g_socket_service_stop" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36609">Stops the service, i.e. stops accepting connections
|
|
from the added sockets when the mainloop runs.
|
|
|
|
This call is thread-safe, so it may be called from a thread
|
|
handling an incoming client request.
|
|
|
|
Note that this only stops accepting new connections; it does not
|
|
close the listening sockets, and you can call
|
|
g_socket_service_start() again later to begin listening again. To
|
|
close the listening sockets, call g_socket_listener_close(). (This
|
|
will happen automatically when the #GSocketService is finalized.)
|
|
|
|
This must be called before calling g_socket_listener_close() as
|
|
the socket service will start accepting connections immediately
|
|
when a new socket is added.</doc>
|
|
<source-position filename="gsocketservice.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="service" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36611">a #GSocketService</doc>
|
|
<type name="SocketService" c:type="GSocketService*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="active" version="2.46" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3389">Whether the service is currently accepting connections.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="SocketListener" c:type="GSocketListener"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="SocketServicePrivate" c:type="GSocketServicePrivate*"/>
|
|
</field>
|
|
<glib:signal name="incoming" when="last" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3369">The ::incoming signal is emitted when a new incoming connection
|
|
to @service needs to be handled. The handler must initiate the
|
|
handling of @connection, but may not block; in essence,
|
|
asynchronous operations must be used.
|
|
|
|
@connection will be unreffed once the signal handler returns,
|
|
so you need to ref it yourself if you are planning to use it.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3384">%TRUE to stop other handlers from being called</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3372">a new #GSocketConnection object</doc>
|
|
<type name="SocketConnection"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3373">the source_object passed to
|
|
g_socket_listener_add_address()</doc>
|
|
<type name="GObject.Object"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="SocketServiceClass" c:type="GSocketServiceClass" glib:is-gtype-struct-for="SocketService">
|
|
<doc xml:space="preserve" filename="gsocketservice.h" line="49">Class structure for #GSocketService.</doc>
|
|
<source-position filename="gsocketservice.h" line="70"/>
|
|
<field name="parent_class">
|
|
<type name="SocketListenerClass" c:type="GSocketListenerClass"/>
|
|
</field>
|
|
<field name="incoming">
|
|
<callback name="incoming">
|
|
<source-position filename="gsocketservice.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="service" transfer-ownership="none">
|
|
<type name="SocketService" c:type="GSocketService*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none">
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gsocketservice.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gsocketservice.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gsocketservice.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gsocketservice.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gsocketservice.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gsocketservice.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="SocketServicePrivate" c:type="GSocketServicePrivate" disguised="1">
|
|
<source-position filename="gsocketservice.h" line="46"/>
|
|
</record>
|
|
<callback name="SocketSourceFunc" c:type="GSocketSourceFunc" version="2.22">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="385">This is the function type of the callback used for the #GSource
|
|
returned by g_socket_create_source().</doc>
|
|
<source-position filename="giotypes.h" line="398"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="394">it should return %FALSE if the source should be removed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="387">the #GSocket</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</parameter>
|
|
<parameter name="condition" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="388">the current condition at the source fired.</doc>
|
|
<type name="GLib.IOCondition" c:type="GIOCondition"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="giotypes.h" line="389">data passed in by the user.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<enumeration name="SocketType" version="2.22" glib:type-name="GSocketType" glib:get-type="g_socket_type_get_type" c:type="GSocketType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="827">Flags used when creating a #GSocket. Some protocols may not implement
|
|
all the socket types.</doc>
|
|
<member name="invalid" value="0" c:identifier="G_SOCKET_TYPE_INVALID" glib:nick="invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="829">Type unknown or wrong</doc>
|
|
</member>
|
|
<member name="stream" value="1" c:identifier="G_SOCKET_TYPE_STREAM" glib:nick="stream">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="830">Reliable connection-based byte streams (e.g. TCP).</doc>
|
|
</member>
|
|
<member name="datagram" value="2" c:identifier="G_SOCKET_TYPE_DATAGRAM" glib:nick="datagram">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="831">Connectionless, unreliable datagram passing.
|
|
(e.g. UDP)</doc>
|
|
</member>
|
|
<member name="seqpacket" value="3" c:identifier="G_SOCKET_TYPE_SEQPACKET" glib:nick="seqpacket">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="833">Reliable connection-based passing of datagrams
|
|
of fixed maximum length (e.g. SCTP).</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="SrvTarget" c:type="GSrvTarget" glib:type-name="GSrvTarget" glib:get-type="g_srv_target_get_type" c:symbol-prefix="srv_target">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8611">SRV (service) records are used by some network protocols to provide
|
|
service-specific aliasing and load-balancing. For example, XMPP
|
|
(Jabber) uses SRV records to locate the XMPP server for a domain;
|
|
rather than connecting directly to "example.com" or assuming a
|
|
specific server hostname like "xmpp.example.com", an XMPP client
|
|
would look up the "xmpp-client" SRV record for "example.com", and
|
|
then connect to whatever host was pointed to by that record.
|
|
|
|
You can use g_resolver_lookup_service() or
|
|
g_resolver_lookup_service_async() to find the #GSrvTargets
|
|
for a given service. However, if you are simply planning to connect
|
|
to the remote service, you can use #GNetworkService's
|
|
#GSocketConnectable interface and not need to worry about
|
|
#GSrvTarget at all.</doc>
|
|
<source-position filename="giotypes.h" line="206"/>
|
|
<constructor name="new" c:identifier="g_srv_target_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36930">Creates a new #GSrvTarget with the given parameters.
|
|
|
|
You should not need to use this; normally #GSrvTargets are
|
|
created by #GResolver.</doc>
|
|
<source-position filename="gsrvtarget.h" line="35"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36942">a new #GSrvTarget.</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="hostname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36932">the host that the service is running on</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="port" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36933">the port that the service is running on</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36934">the target's priority</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
<parameter name="weight" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36935">the target's weight</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="copy" c:identifier="g_srv_target_copy" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36847">Copies @target</doc>
|
|
<source-position filename="gsrvtarget.h" line="40"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36853">a copy of @target</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="target" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36849">a #GSrvTarget</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="g_srv_target_free" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36858">Frees @target</doc>
|
|
<source-position filename="gsrvtarget.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="target" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36860">a #GSrvTarget</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_hostname" c:identifier="g_srv_target_get_hostname" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36868">Gets @target's hostname (in ASCII form; if you are going to present
|
|
this to the user, you should use g_hostname_is_ascii_encoded() to
|
|
check if it contains encoded Unicode segments, and use
|
|
g_hostname_to_unicode() to convert it if it does.)</doc>
|
|
<source-position filename="gsrvtarget.h" line="45"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36877">@target's hostname</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="target" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36870">a #GSrvTarget</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_port" c:identifier="g_srv_target_get_port" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36882">Gets @target's port</doc>
|
|
<source-position filename="gsrvtarget.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36888">@target's port</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="target" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36884">a #GSrvTarget</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_priority" c:identifier="g_srv_target_get_priority" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36893">Gets @target's priority. You should not need to look at this;
|
|
#GResolver already sorts the targets according to the algorithm in
|
|
RFC 2782.</doc>
|
|
<source-position filename="gsrvtarget.h" line="49"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36901">@target's priority</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="target" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36895">a #GSrvTarget</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_weight" c:identifier="g_srv_target_get_weight" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36906">Gets @target's weight. You should not need to look at this;
|
|
#GResolver already sorts the targets according to the algorithm in
|
|
RFC 2782.</doc>
|
|
<source-position filename="gsrvtarget.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36914">@target's weight</doc>
|
|
<type name="guint16" c:type="guint16"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="target" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36908">a #GSrvTarget</doc>
|
|
<type name="SrvTarget" c:type="GSrvTarget*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<function name="list_sort" c:identifier="g_srv_target_list_sort" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36919">Sorts @targets in place according to the algorithm in RFC 2782.</doc>
|
|
<source-position filename="gsrvtarget.h" line="54"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36925">the head of the sorted list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="targets" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36921">a #GList of #GSrvTarget</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</record>
|
|
<record name="StaticResource" c:type="GStaticResource">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3405">#GStaticResource is an opaque data structure and can only be accessed
|
|
using the following functions.</doc>
|
|
<source-position filename="gresource.h" line="60"/>
|
|
<field name="data" readable="0" private="1">
|
|
<type name="guint8" c:type="const guint8*"/>
|
|
</field>
|
|
<field name="data_len" readable="0" private="1">
|
|
<type name="gsize" c:type="gsize"/>
|
|
</field>
|
|
<field name="resource" readable="0" private="1">
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</field>
|
|
<field name="next" readable="0" private="1">
|
|
<type name="StaticResource" c:type="GStaticResource*"/>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</field>
|
|
<method name="fini" c:identifier="g_static_resource_fini" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36947">Finalized a GResource initialized by g_static_resource_init().
|
|
|
|
This is normally used by code generated by
|
|
[glib-compile-resources][glib-compile-resources]
|
|
and is not typically used by other code.</doc>
|
|
<source-position filename="gresource.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="static_resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36949">pointer to a static #GStaticResource</doc>
|
|
<type name="StaticResource" c:type="GStaticResource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_resource" c:identifier="g_static_resource_get_resource" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36961">Gets the GResource that was registered by a call to g_static_resource_init().
|
|
|
|
This is normally used by code generated by
|
|
[glib-compile-resources][glib-compile-resources]
|
|
and is not typically used by other code.</doc>
|
|
<source-position filename="gresource.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36971">a #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="static_resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36963">pointer to a static #GStaticResource</doc>
|
|
<type name="StaticResource" c:type="GStaticResource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="init" c:identifier="g_static_resource_init" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36976">Initializes a GResource from static data using a
|
|
GStaticResource.
|
|
|
|
This is normally used by code generated by
|
|
[glib-compile-resources][glib-compile-resources]
|
|
and is not typically used by other code.</doc>
|
|
<source-position filename="gresource.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="static_resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36978">pointer to a static #GStaticResource</doc>
|
|
<type name="StaticResource" c:type="GStaticResource*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<class name="Subprocess" c:symbol-prefix="subprocess" c:type="GSubprocess" version="2.40" parent="GObject.Object" glib:type-name="GSubprocess" glib:get-type="g_subprocess_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8633">#GSubprocess allows the creation of and interaction with child
|
|
processes.
|
|
|
|
Processes can be communicated with using standard GIO-style APIs (ie:
|
|
#GInputStream, #GOutputStream). There are GIO-style APIs to wait for
|
|
process termination (ie: cancellable and with an asynchronous
|
|
variant).
|
|
|
|
There is an API to force a process to terminate, as well as a
|
|
race-free API for sending UNIX signals to a subprocess.
|
|
|
|
One major advantage that GIO brings over the core GLib library is
|
|
comprehensive API for asynchronous I/O, such
|
|
g_output_stream_splice_async(). This makes GSubprocess
|
|
significantly more powerful and flexible than equivalent APIs in
|
|
some other languages such as the `subprocess.py`
|
|
included with Python. For example, using #GSubprocess one could
|
|
create two child processes, reading standard output from the first,
|
|
processing it, and writing to the input stream of the second, all
|
|
without blocking the main loop.
|
|
|
|
A powerful g_subprocess_communicate() API is provided similar to the
|
|
`communicate()` method of `subprocess.py`. This enables very easy
|
|
interaction with a subprocess that has been opened with pipes.
|
|
|
|
#GSubprocess defaults to tight control over the file descriptors open
|
|
in the child process, avoiding dangling-fd issues that are caused by
|
|
a simple fork()/exec(). The only open file descriptors in the
|
|
spawned process are ones that were explicitly specified by the
|
|
#GSubprocess API (unless %G_SUBPROCESS_FLAGS_INHERIT_FDS was
|
|
specified).
|
|
|
|
#GSubprocess will quickly reap all child processes as they exit,
|
|
avoiding "zombie processes" remaining around for long periods of
|
|
time. g_subprocess_wait() can be used to wait for this to happen,
|
|
but it will happen even without the call being explicitly made.
|
|
|
|
As a matter of principle, #GSubprocess has no API that accepts
|
|
shell-style space-separated strings. It will, however, match the
|
|
typical shell behaviour of searching the PATH for executables that do
|
|
not contain a directory separator in their name.
|
|
|
|
#GSubprocess attempts to have a very simple API for most uses (ie:
|
|
spawning a subprocess with arguments and support for most typical
|
|
kinds of input and output redirection). See g_subprocess_new(). The
|
|
#GSubprocessLauncher API is provided for more complicated cases
|
|
(advanced types of redirection, environment variable manipulation,
|
|
change of working directory, child setup functions, etc).
|
|
|
|
A typical use of #GSubprocess will involve calling
|
|
g_subprocess_new(), followed by g_subprocess_wait_async() or
|
|
g_subprocess_wait(). After the process exits, the status can be
|
|
checked using functions such as g_subprocess_get_if_exited() (which
|
|
are similar to the familiar WIFEXITED-style POSIX macros).</doc>
|
|
<implements name="Initable"/>
|
|
<constructor name="new" c:identifier="g_subprocess_new" shadowed-by="newv" version="2.40" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37646">Create a new process with the given flags and varargs argument
|
|
list. By default, matching the g_spawn_async() defaults, the
|
|
child's stdin will be set to the system null device, and
|
|
stdout/stderr will be inherited from the parent. You can use
|
|
@flags to control this behavior.
|
|
|
|
The argument list must be terminated with %NULL.</doc>
|
|
<source-position filename="gsubprocess.h" line="42"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37661">A newly created #GSubprocess, or %NULL on error (and @error
|
|
will be set)</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37648">flags that define the behaviour of the subprocess</doc>
|
|
<type name="SubprocessFlags" c:type="GSubprocessFlags"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37649">return location for an error, or %NULL</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="argv0" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37650">first commandline argument to pass to the subprocess</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37651">more commandline arguments, followed by %NULL</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="newv" c:identifier="g_subprocess_newv" shadows="new" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37667">Create a new process with the given flags and argument list.
|
|
|
|
The argument list is expected to be %NULL-terminated.</doc>
|
|
<source-position filename="gsubprocess.h" line="47"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37677">A newly created #GSubprocess, or %NULL on error (and @error
|
|
will be set)</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="argv" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37669">commandline arguments for the subprocess</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="filename"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37670">flags that define the behaviour of the subprocess</doc>
|
|
<type name="SubprocessFlags" c:type="GSubprocessFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="communicate" c:identifier="g_subprocess_communicate" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36991">Communicate with the subprocess until it terminates, and all input
|
|
and output has been completed.
|
|
|
|
If @stdin_buf is given, the subprocess must have been created with
|
|
%G_SUBPROCESS_FLAGS_STDIN_PIPE. The given data is fed to the
|
|
stdin of the subprocess and the pipe is closed (ie: EOF).
|
|
|
|
At the same time (as not to cause blocking when dealing with large
|
|
amounts of data), if %G_SUBPROCESS_FLAGS_STDOUT_PIPE or
|
|
%G_SUBPROCESS_FLAGS_STDERR_PIPE were used, reads from those
|
|
streams. The data that was read is returned in @stdout and/or
|
|
the @stderr.
|
|
|
|
If the subprocess was created with %G_SUBPROCESS_FLAGS_STDOUT_PIPE,
|
|
@stdout_buf will contain the data read from stdout. Otherwise, for
|
|
subprocesses not created with %G_SUBPROCESS_FLAGS_STDOUT_PIPE,
|
|
@stdout_buf will be set to %NULL. Similar provisions apply to
|
|
@stderr_buf and %G_SUBPROCESS_FLAGS_STDERR_PIPE.
|
|
|
|
As usual, any output variable may be given as %NULL to ignore it.
|
|
|
|
If you desire the stdout and stderr data to be interleaved, create
|
|
the subprocess with %G_SUBPROCESS_FLAGS_STDOUT_PIPE and
|
|
%G_SUBPROCESS_FLAGS_STDERR_MERGE. The merged result will be returned
|
|
in @stdout_buf and @stderr_buf will be set to %NULL.
|
|
|
|
In case of any error (including cancellation), %FALSE will be
|
|
returned with @error set. Some or all of the stdin data may have
|
|
been written. Any stdout or stderr data that has been read will be
|
|
discarded. None of the out variables (aside from @error) will have
|
|
been set to anything in particular and should not be inspected.
|
|
|
|
In the case that %TRUE is returned, the subprocess has exited and the
|
|
exit status inspection APIs (eg: g_subprocess_get_if_exited(),
|
|
g_subprocess_get_exit_status()) may be used.
|
|
|
|
You should not attempt to use any of the subprocess pipes after
|
|
starting this function, since they may be left in strange states,
|
|
even if the operation was cancelled. You should especially not
|
|
attempt to interact with the pipes while the operation is in progress
|
|
(either from another thread or if using the asynchronous version).</doc>
|
|
<source-position filename="gsubprocess.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37042">%TRUE if successful</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36993">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="stdin_buf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36994">data to send to the stdin of the subprocess, or %NULL</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36995">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="stdout_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36996">data read from the subprocess stdout</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes**"/>
|
|
</parameter>
|
|
<parameter name="stderr_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36997">data read from the subprocess stderr</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="communicate_async" c:identifier="g_subprocess_communicate_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37047">Asynchronous version of g_subprocess_communicate(). Complete
|
|
invocation with g_subprocess_communicate_finish().</doc>
|
|
<source-position filename="gsubprocess.h" line="131"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37049">Self</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="stdin_buf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37050">Input data, or %NULL</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37051">Cancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37052">Callback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37053">User data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="communicate_finish" c:identifier="g_subprocess_communicate_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37060">Complete an invocation of g_subprocess_communicate_async().</doc>
|
|
<source-position filename="gsubprocess.h" line="138"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37062">Self</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37063">Result</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="stdout_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37064">Return location for stdout data</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes**"/>
|
|
</parameter>
|
|
<parameter name="stderr_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37065">Return location for stderr data</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="communicate_utf8" c:identifier="g_subprocess_communicate_utf8" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37072">Like g_subprocess_communicate(), but validates the output of the
|
|
process as UTF-8, and returns it as a regular NUL terminated string.
|
|
|
|
On error, @stdout_buf and @stderr_buf will be set to undefined values and
|
|
should not be used.</doc>
|
|
<source-position filename="gsubprocess.h" line="145"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37074">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="stdin_buf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37075">data to send to the stdin of the subprocess, or %NULL</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37076">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="stdout_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37077">data read from the subprocess stdout</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
<parameter name="stderr_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37078">data read from the subprocess stderr</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="communicate_utf8_async" c:identifier="g_subprocess_communicate_utf8_async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37089">Asynchronous version of g_subprocess_communicate_utf8(). Complete
|
|
invocation with g_subprocess_communicate_utf8_finish().</doc>
|
|
<source-position filename="gsubprocess.h" line="152"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37091">Self</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="stdin_buf" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37092">Input data, or %NULL</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37093">Cancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37094">Callback</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37095">User data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="communicate_utf8_finish" c:identifier="g_subprocess_communicate_utf8_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37102">Complete an invocation of g_subprocess_communicate_utf8_async().</doc>
|
|
<source-position filename="gsubprocess.h" line="159"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37104">Self</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37105">Result</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="stdout_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37106">Return location for stdout data</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
<parameter name="stderr_buf" direction="out" caller-allocates="0" transfer-ownership="full" nullable="1" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37107">Return location for stderr data</doc>
|
|
<type name="utf8" c:type="char**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="force_exit" c:identifier="g_subprocess_force_exit" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37114">Use an operating-system specific method to attempt an immediate,
|
|
forceful termination of the process. There is no mechanism to
|
|
determine whether or not the request itself was successful;
|
|
however, you can use g_subprocess_wait() to monitor the status of
|
|
the process after calling this function.
|
|
|
|
On Unix, this function sends %SIGKILL.</doc>
|
|
<source-position filename="gsubprocess.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37116">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_exit_status" c:identifier="g_subprocess_get_exit_status" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37130">Check the exit status of the subprocess, given that it exited
|
|
normally. This is the value passed to the exit() system call or the
|
|
return value from main.
|
|
|
|
This is equivalent to the system WEXITSTATUS macro.
|
|
|
|
It is an error to call this function before g_subprocess_wait() and
|
|
unless g_subprocess_get_if_exited() returned %TRUE.</doc>
|
|
<source-position filename="gsubprocess.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37143">the exit status</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37132">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_identifier" c:identifier="g_subprocess_get_identifier" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37148">On UNIX, returns the process ID as a decimal string.
|
|
On Windows, returns the result of GetProcessId() also as a string.
|
|
If the subprocess has terminated, this will return %NULL.</doc>
|
|
<source-position filename="gsubprocess.h" line="61"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37156">the subprocess identifier, or %NULL if the subprocess
|
|
has terminated</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37150">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_if_exited" c:identifier="g_subprocess_get_if_exited" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37162">Check if the given subprocess exited normally (ie: by way of exit()
|
|
or return from main()).
|
|
|
|
This is equivalent to the system WIFEXITED macro.
|
|
|
|
It is an error to call this function before g_subprocess_wait() has
|
|
returned.</doc>
|
|
<source-position filename="gsubprocess.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37174">%TRUE if the case of a normal exit</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37164">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_if_signaled" c:identifier="g_subprocess_get_if_signaled" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37179">Check if the given subprocess terminated in response to a signal.
|
|
|
|
This is equivalent to the system WIFSIGNALED macro.
|
|
|
|
It is an error to call this function before g_subprocess_wait() has
|
|
returned.</doc>
|
|
<source-position filename="gsubprocess.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37190">%TRUE if the case of termination due to a signal</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37181">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_status" c:identifier="g_subprocess_get_status" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37195">Gets the raw status code of the process, as from waitpid().
|
|
|
|
This value has no particular meaning, but it can be used with the
|
|
macros defined by the system headers such as WIFEXITED. It can also
|
|
be used with g_spawn_check_exit_status().
|
|
|
|
It is more likely that you want to use g_subprocess_get_if_exited()
|
|
followed by g_subprocess_get_exit_status().
|
|
|
|
It is an error to call this function before g_subprocess_wait() has
|
|
returned.</doc>
|
|
<source-position filename="gsubprocess.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37211">the (meaningless) waitpid() exit status from the kernel</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37197">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_stderr_pipe" c:identifier="g_subprocess_get_stderr_pipe" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37216">Gets the #GInputStream from which to read the stderr output of
|
|
@subprocess.
|
|
|
|
The process must have been created with
|
|
%G_SUBPROCESS_FLAGS_STDERR_PIPE.</doc>
|
|
<source-position filename="gsubprocess.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37226">the stderr pipe</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37218">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_stdin_pipe" c:identifier="g_subprocess_get_stdin_pipe" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37231">Gets the #GOutputStream that you can write to in order to give data
|
|
to the stdin of @subprocess.
|
|
|
|
The process must have been created with
|
|
%G_SUBPROCESS_FLAGS_STDIN_PIPE.</doc>
|
|
<source-position filename="gsubprocess.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37241">the stdout pipe</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37233">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_stdout_pipe" c:identifier="g_subprocess_get_stdout_pipe" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37246">Gets the #GInputStream from which to read the stdout output of
|
|
@subprocess.
|
|
|
|
The process must have been created with
|
|
%G_SUBPROCESS_FLAGS_STDOUT_PIPE.</doc>
|
|
<source-position filename="gsubprocess.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37256">the stdout pipe</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37248">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_successful" c:identifier="g_subprocess_get_successful" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37261">Checks if the process was "successful". A process is considered
|
|
successful if it exited cleanly with an exit status of 0, either by
|
|
way of the exit() system call or return from main().
|
|
|
|
It is an error to call this function before g_subprocess_wait() has
|
|
returned.</doc>
|
|
<source-position filename="gsubprocess.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37272">%TRUE if the process exited cleanly with a exit status of 0</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37263">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_term_sig" c:identifier="g_subprocess_get_term_sig" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37277">Get the signal number that caused the subprocess to terminate, given
|
|
that it terminated due to a signal.
|
|
|
|
This is equivalent to the system WTERMSIG macro.
|
|
|
|
It is an error to call this function before g_subprocess_wait() and
|
|
unless g_subprocess_get_if_signaled() returned %TRUE.</doc>
|
|
<source-position filename="gsubprocess.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37289">the signal causing termination</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37279">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_signal" c:identifier="g_subprocess_send_signal" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37683">Sends the UNIX signal @signal_num to the subprocess, if it is still
|
|
running.
|
|
|
|
This API is race-free. If the subprocess has terminated, it will not
|
|
be signalled.
|
|
|
|
This API is not available on Windows.</doc>
|
|
<source-position filename="gsubprocess.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37685">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="signal_num" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37686">the signal number to send</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait" c:identifier="g_subprocess_wait" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37700">Synchronously wait for the subprocess to terminate.
|
|
|
|
After the process terminates you can query its exit status with
|
|
functions such as g_subprocess_get_if_exited() and
|
|
g_subprocess_get_exit_status().
|
|
|
|
This function does not fail in the case of the subprocess having
|
|
abnormal termination. See g_subprocess_wait_check() for that.
|
|
|
|
Cancelling @cancellable doesn't kill the subprocess. Call
|
|
g_subprocess_force_exit() if it is desirable.</doc>
|
|
<source-position filename="gsubprocess.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37718">%TRUE on success, %FALSE if @cancellable was cancelled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37702">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37703">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_async" c:identifier="g_subprocess_wait_async" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37723">Wait for the subprocess to terminate.
|
|
|
|
This is the asynchronous version of g_subprocess_wait().</doc>
|
|
<source-position filename="gsubprocess.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37725">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37726">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37727">a #GAsyncReadyCallback to call when the operation is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37728">user_data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_check" c:identifier="g_subprocess_wait_check" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37738">Combines g_subprocess_wait() with g_spawn_check_exit_status().</doc>
|
|
<source-position filename="gsubprocess.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37746">%TRUE on success, %FALSE if process exited abnormally, or
|
|
@cancellable was cancelled</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37740">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37741">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_check_async" c:identifier="g_subprocess_wait_check_async" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37752">Combines g_subprocess_wait_async() with g_spawn_check_exit_status().
|
|
|
|
This is the asynchronous version of g_subprocess_wait_check().</doc>
|
|
<source-position filename="gsubprocess.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37754">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37755">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37756">a #GAsyncReadyCallback to call when the operation is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37757">user_data for @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_check_finish" c:identifier="g_subprocess_wait_check_finish" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37767">Collects the result of a previous call to
|
|
g_subprocess_wait_check_async().</doc>
|
|
<source-position filename="gsubprocess.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37776">%TRUE if successful, or %FALSE with @error set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37769">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37770">the #GAsyncResult passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="wait_finish" c:identifier="g_subprocess_wait_finish" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37781">Collects the result of a previous call to
|
|
g_subprocess_wait_async().</doc>
|
|
<source-position filename="gsubprocess.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37790">%TRUE if successful, or %FALSE with @error set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="subprocess" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37783">a #GSubprocess</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37784">the #GAsyncResult passed to your #GAsyncReadyCallback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="argv" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</property>
|
|
<property name="flags" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="SubprocessFlags"/>
|
|
</property>
|
|
</class>
|
|
<bitfield name="SubprocessFlags" version="2.40" glib:type-name="GSubprocessFlags" glib:get-type="g_subprocess_flags_get_type" c:type="GSubprocessFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1843">Flags to define the behaviour of a #GSubprocess.
|
|
|
|
Note that the default for stdin is to redirect from `/dev/null`. For
|
|
stdout and stderr the default are for them to inherit the
|
|
corresponding descriptor from the calling process.
|
|
|
|
Note that it is a programmer error to mix 'incompatible' flags. For
|
|
example, you may not request both %G_SUBPROCESS_FLAGS_STDOUT_PIPE and
|
|
%G_SUBPROCESS_FLAGS_STDOUT_SILENCE.</doc>
|
|
<member name="none" value="0" c:identifier="G_SUBPROCESS_FLAGS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1845">No flags.</doc>
|
|
</member>
|
|
<member name="stdin_pipe" value="1" c:identifier="G_SUBPROCESS_FLAGS_STDIN_PIPE" glib:nick="stdin-pipe">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1846">create a pipe for the stdin of the
|
|
spawned process that can be accessed with
|
|
g_subprocess_get_stdin_pipe().</doc>
|
|
</member>
|
|
<member name="stdin_inherit" value="2" c:identifier="G_SUBPROCESS_FLAGS_STDIN_INHERIT" glib:nick="stdin-inherit">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1849">stdin is inherited from the
|
|
calling process.</doc>
|
|
</member>
|
|
<member name="stdout_pipe" value="4" c:identifier="G_SUBPROCESS_FLAGS_STDOUT_PIPE" glib:nick="stdout-pipe">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1851">create a pipe for the stdout of the
|
|
spawned process that can be accessed with
|
|
g_subprocess_get_stdout_pipe().</doc>
|
|
</member>
|
|
<member name="stdout_silence" value="8" c:identifier="G_SUBPROCESS_FLAGS_STDOUT_SILENCE" glib:nick="stdout-silence">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1854">silence the stdout of the spawned
|
|
process (ie: redirect to `/dev/null`).</doc>
|
|
</member>
|
|
<member name="stderr_pipe" value="16" c:identifier="G_SUBPROCESS_FLAGS_STDERR_PIPE" glib:nick="stderr-pipe">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1856">create a pipe for the stderr of the
|
|
spawned process that can be accessed with
|
|
g_subprocess_get_stderr_pipe().</doc>
|
|
</member>
|
|
<member name="stderr_silence" value="32" c:identifier="G_SUBPROCESS_FLAGS_STDERR_SILENCE" glib:nick="stderr-silence">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1859">silence the stderr of the spawned
|
|
process (ie: redirect to `/dev/null`).</doc>
|
|
</member>
|
|
<member name="stderr_merge" value="64" c:identifier="G_SUBPROCESS_FLAGS_STDERR_MERGE" glib:nick="stderr-merge">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1861">merge the stderr of the spawned
|
|
process with whatever the stdout happens to be. This is a good way
|
|
of directing both streams to a common log file, for example.</doc>
|
|
</member>
|
|
<member name="inherit_fds" value="128" c:identifier="G_SUBPROCESS_FLAGS_INHERIT_FDS" glib:nick="inherit-fds">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1864">spawned processes will inherit the
|
|
file descriptors of their parent, unless those descriptors have
|
|
been explicitly marked as close-on-exec. This flag has no effect
|
|
over the "standard" file descriptors (stdin, stdout, stderr).</doc>
|
|
</member>
|
|
</bitfield>
|
|
<class name="SubprocessLauncher" c:symbol-prefix="subprocess_launcher" c:type="GSubprocessLauncher" version="2.40" parent="GObject.Object" glib:type-name="GSubprocessLauncher" glib:get-type="g_subprocess_launcher_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8699">This class contains a set of options for launching child processes,
|
|
such as where its standard input and output will be directed, the
|
|
argument list, the environment, and more.
|
|
|
|
While the #GSubprocess class has high level functions covering
|
|
popular cases, use of this class allows access to more advanced
|
|
options. It can also be used to launch multiple subprocesses with
|
|
a similar configuration.</doc>
|
|
<constructor name="new" c:identifier="g_subprocess_launcher_new" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37311">Creates a new #GSubprocessLauncher.
|
|
|
|
The launcher is created with the default options. A copy of the
|
|
environment of the calling process is made at the time of this call
|
|
and will be used as the environment that the process is launched in.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="42"/>
|
|
<return-value transfer-ownership="full">
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37313">#GSubprocessFlags</doc>
|
|
<type name="SubprocessFlags" c:type="GSubprocessFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="getenv" c:identifier="g_subprocess_launcher_getenv" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37294">Returns the value of the environment variable @variable in the
|
|
environment of processes launched from this launcher.
|
|
|
|
On UNIX, the returned string can be an arbitrary byte string.
|
|
On Windows, it will be UTF-8.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37305">the value of the environment variable,
|
|
%NULL if unset</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37296">a #GSubprocess</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="variable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37297">the environment variable to get</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_child_setup" c:identifier="g_subprocess_launcher_set_child_setup" version="2.40" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37325">Sets up a child setup function.
|
|
|
|
The child setup function will be called after fork() but before
|
|
exec() on the child's side.
|
|
|
|
@destroy_notify will not be automatically called on the child's side
|
|
of the fork(). It will only be called when the last reference on the
|
|
#GSubprocessLauncher is dropped or when a new child setup function is
|
|
given.
|
|
|
|
%NULL can be given as @child_setup to disable the functionality.
|
|
|
|
Child setup functions are only available on UNIX.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37327">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="child_setup" transfer-ownership="none" scope="notified" closure="1" destroy="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37328">a #GSpawnChildSetupFunc to use as the child setup function</doc>
|
|
<type name="GLib.SpawnChildSetupFunc" c:type="GSpawnChildSetupFunc"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37329">user data for @child_setup</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="destroy_notify" transfer-ownership="none" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37330">a #GDestroyNotify for @user_data</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_cwd" c:identifier="g_subprocess_launcher_set_cwd" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37350">Sets the current working directory that processes will be launched
|
|
with.
|
|
|
|
By default processes are launched with the current working directory
|
|
of the launching process at the time of launch.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37352">a #GSubprocess</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="cwd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37353">the cwd for launched processes</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_environ" c:identifier="g_subprocess_launcher_set_environ" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37365">Replace the entire environment of processes launched from this
|
|
launcher with the given 'environ' variable.
|
|
|
|
Typically you will build this variable by using g_listenv() to copy
|
|
the process 'environ' and using the functions g_environ_setenv(),
|
|
g_environ_unsetenv(), etc.
|
|
|
|
As an alternative, you can use g_subprocess_launcher_setenv(),
|
|
g_subprocess_launcher_unsetenv(), etc.
|
|
|
|
Pass an empty array to set an empty environment. Pass %NULL to inherit the
|
|
parent process’ environment. As of GLib 2.54, the parent process’ environment
|
|
will be copied when g_subprocess_launcher_set_environ() is called.
|
|
Previously, it was copied when the subprocess was executed. This means the
|
|
copied environment may now be modified (using g_subprocess_launcher_setenv(),
|
|
etc.) before launching the subprocess.
|
|
|
|
On UNIX, all strings in this array can be arbitrary byte strings.
|
|
On Windows, they should be in UTF-8.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37367">a #GSubprocess</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="env" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37368">
|
|
the replacement environment</doc>
|
|
<array c:type="gchar**">
|
|
<type name="filename"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flags" c:identifier="g_subprocess_launcher_set_flags" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37395">Sets the flags on the launcher.
|
|
|
|
The default flags are %G_SUBPROCESS_FLAGS_NONE.
|
|
|
|
You may not set flags that specify conflicting options for how to
|
|
handle a particular stdio stream (eg: specifying both
|
|
%G_SUBPROCESS_FLAGS_STDIN_PIPE and
|
|
%G_SUBPROCESS_FLAGS_STDIN_INHERIT).
|
|
|
|
You may also not set a flag that conflicts with a previous call to a
|
|
function like g_subprocess_launcher_set_stdin_file_path() or
|
|
g_subprocess_launcher_take_stdout_fd().</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37397">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37398">#GSubprocessFlags</doc>
|
|
<type name="SubprocessFlags" c:type="GSubprocessFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_stderr_file_path" c:identifier="g_subprocess_launcher_set_stderr_file_path" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37417">Sets the file path to use as the stderr for spawned processes.
|
|
|
|
If @path is %NULL then any previously given path is unset.
|
|
|
|
The file will be created or truncated when the process is spawned, as
|
|
would be the case if using '2>' at the shell.
|
|
|
|
If you want to send both stdout and stderr to the same file then use
|
|
%G_SUBPROCESS_FLAGS_STDERR_MERGE.
|
|
|
|
You may not set a stderr file path if a stderr fd is already set or
|
|
if the launcher flags contain any flags directing stderr elsewhere.
|
|
|
|
This feature is only available on UNIX.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37419">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37420">a filename or %NULL</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_stdin_file_path" c:identifier="g_subprocess_launcher_set_stdin_file_path" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37441">Sets the file path to use as the stdin for spawned processes.
|
|
|
|
If @path is %NULL then any previously given path is unset.
|
|
|
|
The file must exist or spawning the process will fail.
|
|
|
|
You may not set a stdin file path if a stdin fd is already set or if
|
|
the launcher flags contain any flags directing stdin elsewhere.
|
|
|
|
This feature is only available on UNIX.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37443">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_stdout_file_path" c:identifier="g_subprocess_launcher_set_stdout_file_path" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37461">Sets the file path to use as the stdout for spawned processes.
|
|
|
|
If @path is %NULL then any previously given path is unset.
|
|
|
|
The file will be created or truncated when the process is spawned, as
|
|
would be the case if using '>' at the shell.
|
|
|
|
You may not set a stdout file path if a stdout fd is already set or
|
|
if the launcher flags contain any flags directing stdout elsewhere.
|
|
|
|
This feature is only available on UNIX.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37463">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37464">a filename or %NULL</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="setenv" c:identifier="g_subprocess_launcher_setenv" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37482">Sets the environment variable @variable in the environment of
|
|
processes launched from this launcher.
|
|
|
|
On UNIX, both the variable's name and value can be arbitrary byte
|
|
strings, except that the variable's name cannot contain '='.
|
|
On Windows, they should be in UTF-8.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37484">a #GSubprocess</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="variable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37485">the environment variable to set,
|
|
must not contain '='</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37487">the new value for the variable</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="overwrite" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37488">whether to change the variable if it already exists</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="spawn" c:identifier="g_subprocess_launcher_spawn" version="2.40" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37501">Creates a #GSubprocess given a provided varargs list of arguments.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="45"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37511">A new #GSubprocess, or %NULL on error (and @error will be set)</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37503">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37504">Error</doc>
|
|
<type name="GLib.Error" c:type="GError**"/>
|
|
</parameter>
|
|
<parameter name="argv0" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37505">Command line arguments</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37506">Continued arguments, %NULL terminated</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="spawnv" c:identifier="g_subprocess_launcher_spawnv" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37515">Creates a #GSubprocess given a provided array of arguments.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="51"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37524">A new #GSubprocess, or %NULL on error (and @error will be set)</doc>
|
|
<type name="Subprocess" c:type="GSubprocess*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37517">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="argv" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37518">Command line arguments</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="filename"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_fd" c:identifier="g_subprocess_launcher_take_fd">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37528">Transfer an arbitrary file descriptor from parent process to the
|
|
child. This function takes "ownership" of the fd; it will be closed
|
|
in the parent when @self is freed.
|
|
|
|
By default, all file descriptors from the parent will be closed.
|
|
This function allows you to create (for example) a custom pipe() or
|
|
socketpair() before launching the process, and choose the target
|
|
descriptor in the child.
|
|
|
|
An example use case is GNUPG, which has a command line argument
|
|
--passphrase-fd providing a file descriptor number where it expects
|
|
the passphrase to be written.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37530">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="source_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37531">File descriptor in parent process</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="target_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37532">Target descriptor for child process</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_stderr_fd" c:identifier="g_subprocess_launcher_take_stderr_fd" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37549">Sets the file descriptor to use as the stderr for spawned processes.
|
|
|
|
If @fd is -1 then any previously given fd is unset.
|
|
|
|
Note that the default behaviour is to pass stderr through to the
|
|
stderr of the parent process.
|
|
|
|
The passed @fd belongs to the #GSubprocessLauncher. It will be
|
|
automatically closed when the launcher is finalized. The file
|
|
descriptor will also be closed on the child side when executing the
|
|
spawned process.
|
|
|
|
You may not set a stderr fd if a stderr file path is already set or
|
|
if the launcher flags contain any flags directing stderr elsewhere.
|
|
|
|
This feature is only available on UNIX.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37551">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37552">a file descriptor, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_stdin_fd" c:identifier="g_subprocess_launcher_take_stdin_fd" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37575">Sets the file descriptor to use as the stdin for spawned processes.
|
|
|
|
If @fd is -1 then any previously given fd is unset.
|
|
|
|
Note that if your intention is to have the stdin of the calling
|
|
process inherited by the child then %G_SUBPROCESS_FLAGS_STDIN_INHERIT
|
|
is a better way to go about doing that.
|
|
|
|
The passed @fd is noted but will not be touched in the current
|
|
process. It is therefore necessary that it be kept open by the
|
|
caller until the subprocess is spawned. The file descriptor will
|
|
also not be explicitly closed on the child side, so it must be marked
|
|
O_CLOEXEC if that's what you want.
|
|
|
|
You may not set a stdin fd if a stdin file path is already set or if
|
|
the launcher flags contain any flags directing stdin elsewhere.
|
|
|
|
This feature is only available on UNIX.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37577">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37578">a file descriptor, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="take_stdout_fd" c:identifier="g_subprocess_launcher_take_stdout_fd" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37603">Sets the file descriptor to use as the stdout for spawned processes.
|
|
|
|
If @fd is -1 then any previously given fd is unset.
|
|
|
|
Note that the default behaviour is to pass stdout through to the
|
|
stdout of the parent process.
|
|
|
|
The passed @fd is noted but will not be touched in the current
|
|
process. It is therefore necessary that it be kept open by the
|
|
caller until the subprocess is spawned. The file descriptor will
|
|
also not be explicitly closed on the child side, so it must be marked
|
|
O_CLOEXEC if that's what you want.
|
|
|
|
You may not set a stdout fd if a stdout file path is already set or
|
|
if the launcher flags contain any flags directing stdout elsewhere.
|
|
|
|
This feature is only available on UNIX.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37605">a #GSubprocessLauncher</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37606">a file descriptor, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unsetenv" c:identifier="g_subprocess_launcher_unsetenv" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37630">Removes the environment variable @variable from the environment of
|
|
processes launched from this launcher.
|
|
|
|
On UNIX, the variable's name can be an arbitrary byte string not
|
|
containing '='. On Windows, it should be in UTF-8.</doc>
|
|
<source-position filename="gsubprocesslauncher.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37632">a #GSubprocess</doc>
|
|
<type name="SubprocessLauncher" c:type="GSubprocessLauncher*"/>
|
|
</instance-parameter>
|
|
<parameter name="variable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37633">the environment variable to unset,
|
|
must not contain '='</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="flags" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="SubprocessFlags"/>
|
|
</property>
|
|
</class>
|
|
<function-macro name="TASK" c:identifier="G_TASK" introspectable="0">
|
|
<source-position filename="gtask.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TASK_CLASS" c:identifier="G_TASK_CLASS" introspectable="0">
|
|
<source-position filename="gtask.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TASK_GET_CLASS" c:identifier="G_TASK_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtask.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TCP_CONNECTION" c:identifier="G_TCP_CONNECTION" introspectable="0">
|
|
<source-position filename="gtcpconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TCP_CONNECTION_CLASS" c:identifier="G_TCP_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gtcpconnection.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TCP_CONNECTION_GET_CLASS" c:identifier="G_TCP_CONNECTION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtcpconnection.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TCP_WRAPPER_CONNECTION" c:identifier="G_TCP_WRAPPER_CONNECTION" introspectable="0">
|
|
<source-position filename="gtcpwrapperconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TCP_WRAPPER_CONNECTION_CLASS" c:identifier="G_TCP_WRAPPER_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gtcpwrapperconnection.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TCP_WRAPPER_CONNECTION_GET_CLASS" c:identifier="G_TCP_WRAPPER_CONNECTION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtcpwrapperconnection.h" line="41"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TEST_DBUS" c:identifier="G_TEST_DBUS" introspectable="0">
|
|
<source-position filename="gtestdbus.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="THEMED_ICON" c:identifier="G_THEMED_ICON" introspectable="0">
|
|
<source-position filename="gthemedicon.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="THEMED_ICON_CLASS" c:identifier="G_THEMED_ICON_CLASS" introspectable="0">
|
|
<source-position filename="gthemedicon.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="THEMED_ICON_GET_CLASS" c:identifier="G_THEMED_ICON_GET_CLASS" introspectable="0">
|
|
<source-position filename="gthemedicon.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="THREADED_SOCKET_SERVICE" c:identifier="G_THREADED_SOCKET_SERVICE" introspectable="0">
|
|
<source-position filename="gthreadedsocketservice.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="THREADED_SOCKET_SERVICE_CLASS" c:identifier="G_THREADED_SOCKET_SERVICE_CLASS" introspectable="0">
|
|
<source-position filename="gthreadedsocketservice.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="THREADED_SOCKET_SERVICE_GET_CLASS" c:identifier="G_THREADED_SOCKET_SERVICE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gthreadedsocketservice.h" line="45"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_BACKEND" c:identifier="G_TLS_BACKEND" introspectable="0">
|
|
<source-position filename="gtlsbackend.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="TLS_BACKEND_EXTENSION_POINT_NAME" value="gio-tls-backend" c:type="G_TLS_BACKEND_EXTENSION_POINT_NAME">
|
|
<doc xml:space="preserve" filename="gtlsbackend.h" line="31">Extension point for TLS functionality via #GTlsBackend.
|
|
See [Extending GIO][extending-gio].</doc>
|
|
<source-position filename="gtlsbackend.h" line="37"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="TLS_BACKEND_GET_INTERFACE" c:identifier="G_TLS_BACKEND_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gtlsbackend.h" line="42"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CERTIFICATE" c:identifier="G_TLS_CERTIFICATE" introspectable="0">
|
|
<source-position filename="gtlscertificate.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CERTIFICATE_CLASS" c:identifier="G_TLS_CERTIFICATE_CLASS" introspectable="0">
|
|
<source-position filename="gtlscertificate.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CERTIFICATE_GET_CLASS" c:identifier="G_TLS_CERTIFICATE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtlscertificate.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CLIENT_CONNECTION" c:identifier="G_TLS_CLIENT_CONNECTION" introspectable="0">
|
|
<source-position filename="gtlsclientconnection.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CLIENT_CONNECTION_GET_INTERFACE" c:identifier="G_TLS_CLIENT_CONNECTION_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gtlsclientconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CONNECTION" c:identifier="G_TLS_CONNECTION" introspectable="0">
|
|
<source-position filename="gtlsconnection.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CONNECTION_CLASS" c:identifier="G_TLS_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gtlsconnection.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_CONNECTION_GET_CLASS" c:identifier="G_TLS_CONNECTION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtlsconnection.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_DATABASE" c:identifier="G_TLS_DATABASE" introspectable="0">
|
|
<source-position filename="gtlsdatabase.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_DATABASE_CLASS" c:identifier="G_TLS_DATABASE_CLASS" introspectable="0">
|
|
<source-position filename="gtlsdatabase.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_DATABASE_GET_CLASS" c:identifier="G_TLS_DATABASE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtlsdatabase.h" line="40"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="TLS_DATABASE_PURPOSE_AUTHENTICATE_CLIENT" value="1.3.6.1.5.5.7.3.2" c:type="G_TLS_DATABASE_PURPOSE_AUTHENTICATE_CLIENT">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4372">The purpose used to verify the client certificate in a TLS connection.
|
|
Used by TLS servers.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="33"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER" value="1.3.6.1.5.5.7.3.1" c:type="G_TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4380">The purpose used to verify the server certificate in a TLS connection. This
|
|
is the most common purpose in use. Used by TLS clients.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="32"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="TLS_FILE_DATABASE" c:identifier="G_TLS_FILE_DATABASE" introspectable="0">
|
|
<source-position filename="gtlsfiledatabase.h" line="27"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_FILE_DATABASE_GET_INTERFACE" c:identifier="G_TLS_FILE_DATABASE_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gtlsfiledatabase.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_INTERACTION" c:identifier="G_TLS_INTERACTION" introspectable="0">
|
|
<source-position filename="gtlsinteraction.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_INTERACTION_CLASS" c:identifier="G_TLS_INTERACTION_CLASS" introspectable="0">
|
|
<source-position filename="gtlsinteraction.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_INTERACTION_GET_CLASS" c:identifier="G_TLS_INTERACTION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtlsinteraction.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_PASSWORD" c:identifier="G_TLS_PASSWORD" introspectable="0">
|
|
<source-position filename="gtlspassword.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_PASSWORD_CLASS" c:identifier="G_TLS_PASSWORD_CLASS" introspectable="0">
|
|
<source-position filename="gtlspassword.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_PASSWORD_GET_CLASS" c:identifier="G_TLS_PASSWORD_GET_CLASS" introspectable="0">
|
|
<source-position filename="gtlspassword.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_SERVER_CONNECTION" c:identifier="G_TLS_SERVER_CONNECTION" introspectable="0">
|
|
<source-position filename="gtlsserverconnection.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TLS_SERVER_CONNECTION_GET_INTERFACE" c:identifier="G_TLS_SERVER_CONNECTION_GET_INTERFACE" introspectable="0">
|
|
<source-position filename="gtlsserverconnection.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TYPE_IS_ASYNC_INITABLE" c:identifier="G_TYPE_IS_ASYNC_INITABLE" introspectable="0">
|
|
<source-position filename="gasyncinitable.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="type">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TYPE_IS_DATAGRAM_BASED" c:identifier="G_TYPE_IS_DATAGRAM_BASED" introspectable="0">
|
|
<source-position filename="gdatagrambased.h" line="39"/>
|
|
<parameters>
|
|
<parameter name="type">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="TYPE_IS_INITABLE" c:identifier="G_TYPE_IS_INITABLE" introspectable="0">
|
|
<source-position filename="ginitable.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="type">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="Task" c:symbol-prefix="task" c:type="GTask" parent="GObject.Object" glib:type-name="GTask" glib:get-type="g_task_get_type" glib:type-struct="TaskClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="8718">A #GTask represents and manages a cancellable "task".
|
|
|
|
## Asynchronous operations
|
|
|
|
The most common usage of #GTask is as a #GAsyncResult, to
|
|
manage data during an asynchronous operation. You call
|
|
g_task_new() in the "start" method, followed by
|
|
g_task_set_task_data() and the like if you need to keep some
|
|
additional data associated with the task, and then pass the
|
|
task object around through your asynchronous operation.
|
|
Eventually, you will call a method such as
|
|
g_task_return_pointer() or g_task_return_error(), which will
|
|
save the value you give it and then invoke the task's callback
|
|
function in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
where it was created (waiting until the next iteration of the main
|
|
loop first, if necessary). The caller will pass the #GTask back to
|
|
the operation's finish function (as a #GAsyncResult), and you can
|
|
use g_task_propagate_pointer() or the like to extract the
|
|
return value.
|
|
|
|
Here is an example for using GTask as a GAsyncResult:
|
|
|[<!-- language="C" -->
|
|
typedef struct {
|
|
CakeFrostingType frosting;
|
|
char *message;
|
|
} DecorationData;
|
|
|
|
static void
|
|
decoration_data_free (DecorationData *decoration)
|
|
{
|
|
g_free (decoration->message);
|
|
g_slice_free (DecorationData, decoration);
|
|
}
|
|
|
|
static void
|
|
baked_cb (Cake *cake,
|
|
gpointer user_data)
|
|
{
|
|
GTask *task = user_data;
|
|
DecorationData *decoration = g_task_get_task_data (task);
|
|
GError *error = NULL;
|
|
|
|
if (cake == NULL)
|
|
{
|
|
g_task_return_new_error (task, BAKER_ERROR, BAKER_ERROR_NO_FLOUR,
|
|
"Go to the supermarket");
|
|
g_object_unref (task);
|
|
return;
|
|
}
|
|
|
|
if (!cake_decorate (cake, decoration->frosting, decoration->message, &error))
|
|
{
|
|
g_object_unref (cake);
|
|
// g_task_return_error() takes ownership of error
|
|
g_task_return_error (task, error);
|
|
g_object_unref (task);
|
|
return;
|
|
}
|
|
|
|
g_task_return_pointer (task, cake, g_object_unref);
|
|
g_object_unref (task);
|
|
}
|
|
|
|
void
|
|
baker_bake_cake_async (Baker *self,
|
|
guint radius,
|
|
CakeFlavor flavor,
|
|
CakeFrostingType frosting,
|
|
const char *message,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
GTask *task;
|
|
DecorationData *decoration;
|
|
Cake *cake;
|
|
|
|
task = g_task_new (self, cancellable, callback, user_data);
|
|
if (radius < 3)
|
|
{
|
|
g_task_return_new_error (task, BAKER_ERROR, BAKER_ERROR_TOO_SMALL,
|
|
"%ucm radius cakes are silly",
|
|
radius);
|
|
g_object_unref (task);
|
|
return;
|
|
}
|
|
|
|
cake = _baker_get_cached_cake (self, radius, flavor, frosting, message);
|
|
if (cake != NULL)
|
|
{
|
|
// _baker_get_cached_cake() returns a reffed cake
|
|
g_task_return_pointer (task, cake, g_object_unref);
|
|
g_object_unref (task);
|
|
return;
|
|
}
|
|
|
|
decoration = g_slice_new (DecorationData);
|
|
decoration->frosting = frosting;
|
|
decoration->message = g_strdup (message);
|
|
g_task_set_task_data (task, decoration, (GDestroyNotify) decoration_data_free);
|
|
|
|
_baker_begin_cake (self, radius, flavor, cancellable, baked_cb, task);
|
|
}
|
|
|
|
Cake *
|
|
baker_bake_cake_finish (Baker *self,
|
|
GAsyncResult *result,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (g_task_is_valid (result, self), NULL);
|
|
|
|
return g_task_propagate_pointer (G_TASK (result), error);
|
|
}
|
|
]|
|
|
|
|
## Chained asynchronous operations
|
|
|
|
#GTask also tries to simplify asynchronous operations that
|
|
internally chain together several smaller asynchronous
|
|
operations. g_task_get_cancellable(), g_task_get_context(),
|
|
and g_task_get_priority() allow you to get back the task's
|
|
#GCancellable, #GMainContext, and [I/O priority][io-priority]
|
|
when starting a new subtask, so you don't have to keep track
|
|
of them yourself. g_task_attach_source() simplifies the case
|
|
of waiting for a source to fire (automatically using the correct
|
|
#GMainContext and priority).
|
|
|
|
Here is an example for chained asynchronous operations:
|
|
|[<!-- language="C" -->
|
|
typedef struct {
|
|
Cake *cake;
|
|
CakeFrostingType frosting;
|
|
char *message;
|
|
} BakingData;
|
|
|
|
static void
|
|
decoration_data_free (BakingData *bd)
|
|
{
|
|
if (bd->cake)
|
|
g_object_unref (bd->cake);
|
|
g_free (bd->message);
|
|
g_slice_free (BakingData, bd);
|
|
}
|
|
|
|
static void
|
|
decorated_cb (Cake *cake,
|
|
GAsyncResult *result,
|
|
gpointer user_data)
|
|
{
|
|
GTask *task = user_data;
|
|
GError *error = NULL;
|
|
|
|
if (!cake_decorate_finish (cake, result, &error))
|
|
{
|
|
g_object_unref (cake);
|
|
g_task_return_error (task, error);
|
|
g_object_unref (task);
|
|
return;
|
|
}
|
|
|
|
// baking_data_free() will drop its ref on the cake, so we have to
|
|
// take another here to give to the caller.
|
|
g_task_return_pointer (task, g_object_ref (cake), g_object_unref);
|
|
g_object_unref (task);
|
|
}
|
|
|
|
static gboolean
|
|
decorator_ready (gpointer user_data)
|
|
{
|
|
GTask *task = user_data;
|
|
BakingData *bd = g_task_get_task_data (task);
|
|
|
|
cake_decorate_async (bd->cake, bd->frosting, bd->message,
|
|
g_task_get_cancellable (task),
|
|
decorated_cb, task);
|
|
|
|
return G_SOURCE_REMOVE;
|
|
}
|
|
|
|
static void
|
|
baked_cb (Cake *cake,
|
|
gpointer user_data)
|
|
{
|
|
GTask *task = user_data;
|
|
BakingData *bd = g_task_get_task_data (task);
|
|
GError *error = NULL;
|
|
|
|
if (cake == NULL)
|
|
{
|
|
g_task_return_new_error (task, BAKER_ERROR, BAKER_ERROR_NO_FLOUR,
|
|
"Go to the supermarket");
|
|
g_object_unref (task);
|
|
return;
|
|
}
|
|
|
|
bd->cake = cake;
|
|
|
|
// Bail out now if the user has already cancelled
|
|
if (g_task_return_error_if_cancelled (task))
|
|
{
|
|
g_object_unref (task);
|
|
return;
|
|
}
|
|
|
|
if (cake_decorator_available (cake))
|
|
decorator_ready (task);
|
|
else
|
|
{
|
|
GSource *source;
|
|
|
|
source = cake_decorator_wait_source_new (cake);
|
|
// Attach @source to @task's GMainContext and have it call
|
|
// decorator_ready() when it is ready.
|
|
g_task_attach_source (task, source, decorator_ready);
|
|
g_source_unref (source);
|
|
}
|
|
}
|
|
|
|
void
|
|
baker_bake_cake_async (Baker *self,
|
|
guint radius,
|
|
CakeFlavor flavor,
|
|
CakeFrostingType frosting,
|
|
const char *message,
|
|
gint priority,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
GTask *task;
|
|
BakingData *bd;
|
|
|
|
task = g_task_new (self, cancellable, callback, user_data);
|
|
g_task_set_priority (task, priority);
|
|
|
|
bd = g_slice_new0 (BakingData);
|
|
bd->frosting = frosting;
|
|
bd->message = g_strdup (message);
|
|
g_task_set_task_data (task, bd, (GDestroyNotify) baking_data_free);
|
|
|
|
_baker_begin_cake (self, radius, flavor, cancellable, baked_cb, task);
|
|
}
|
|
|
|
Cake *
|
|
baker_bake_cake_finish (Baker *self,
|
|
GAsyncResult *result,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (g_task_is_valid (result, self), NULL);
|
|
|
|
return g_task_propagate_pointer (G_TASK (result), error);
|
|
}
|
|
]|
|
|
|
|
## Asynchronous operations from synchronous ones
|
|
|
|
You can use g_task_run_in_thread() to turn a synchronous
|
|
operation into an asynchronous one, by running it in a thread.
|
|
When it completes, the result will be dispatched to the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
where the #GTask was created.
|
|
|
|
Running a task in a thread:
|
|
|[<!-- language="C" -->
|
|
typedef struct {
|
|
guint radius;
|
|
CakeFlavor flavor;
|
|
CakeFrostingType frosting;
|
|
char *message;
|
|
} CakeData;
|
|
|
|
static void
|
|
cake_data_free (CakeData *cake_data)
|
|
{
|
|
g_free (cake_data->message);
|
|
g_slice_free (CakeData, cake_data);
|
|
}
|
|
|
|
static void
|
|
bake_cake_thread (GTask *task,
|
|
gpointer source_object,
|
|
gpointer task_data,
|
|
GCancellable *cancellable)
|
|
{
|
|
Baker *self = source_object;
|
|
CakeData *cake_data = task_data;
|
|
Cake *cake;
|
|
GError *error = NULL;
|
|
|
|
cake = bake_cake (baker, cake_data->radius, cake_data->flavor,
|
|
cake_data->frosting, cake_data->message,
|
|
cancellable, &error);
|
|
if (cake)
|
|
g_task_return_pointer (task, cake, g_object_unref);
|
|
else
|
|
g_task_return_error (task, error);
|
|
}
|
|
|
|
void
|
|
baker_bake_cake_async (Baker *self,
|
|
guint radius,
|
|
CakeFlavor flavor,
|
|
CakeFrostingType frosting,
|
|
const char *message,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
CakeData *cake_data;
|
|
GTask *task;
|
|
|
|
cake_data = g_slice_new (CakeData);
|
|
cake_data->radius = radius;
|
|
cake_data->flavor = flavor;
|
|
cake_data->frosting = frosting;
|
|
cake_data->message = g_strdup (message);
|
|
task = g_task_new (self, cancellable, callback, user_data);
|
|
g_task_set_task_data (task, cake_data, (GDestroyNotify) cake_data_free);
|
|
g_task_run_in_thread (task, bake_cake_thread);
|
|
g_object_unref (task);
|
|
}
|
|
|
|
Cake *
|
|
baker_bake_cake_finish (Baker *self,
|
|
GAsyncResult *result,
|
|
GError **error)
|
|
{
|
|
g_return_val_if_fail (g_task_is_valid (result, self), NULL);
|
|
|
|
return g_task_propagate_pointer (G_TASK (result), error);
|
|
}
|
|
]|
|
|
|
|
## Adding cancellability to uncancellable tasks
|
|
|
|
Finally, g_task_run_in_thread() and g_task_run_in_thread_sync()
|
|
can be used to turn an uncancellable operation into a
|
|
cancellable one. If you call g_task_set_return_on_cancel(),
|
|
passing %TRUE, then if the task's #GCancellable is cancelled,
|
|
it will return control back to the caller immediately, while
|
|
allowing the task thread to continue running in the background
|
|
(and simply discarding its result when it finally does finish).
|
|
Provided that the task thread is careful about how it uses
|
|
locks and other externally-visible resources, this allows you
|
|
to make "GLib-friendly" asynchronous and cancellable
|
|
synchronous variants of blocking APIs.
|
|
|
|
Cancelling a task:
|
|
|[<!-- language="C" -->
|
|
static void
|
|
bake_cake_thread (GTask *task,
|
|
gpointer source_object,
|
|
gpointer task_data,
|
|
GCancellable *cancellable)
|
|
{
|
|
Baker *self = source_object;
|
|
CakeData *cake_data = task_data;
|
|
Cake *cake;
|
|
GError *error = NULL;
|
|
|
|
cake = bake_cake (baker, cake_data->radius, cake_data->flavor,
|
|
cake_data->frosting, cake_data->message,
|
|
&error);
|
|
if (error)
|
|
{
|
|
g_task_return_error (task, error);
|
|
return;
|
|
}
|
|
|
|
// If the task has already been cancelled, then we don't want to add
|
|
// the cake to the cake cache. Likewise, we don't want to have the
|
|
// task get cancelled in the middle of updating the cache.
|
|
// g_task_set_return_on_cancel() will return %TRUE here if it managed
|
|
// to disable return-on-cancel, or %FALSE if the task was cancelled
|
|
// before it could.
|
|
if (g_task_set_return_on_cancel (task, FALSE))
|
|
{
|
|
// If the caller cancels at this point, their
|
|
// GAsyncReadyCallback won't be invoked until we return,
|
|
// so we don't have to worry that this code will run at
|
|
// the same time as that code does. But if there were
|
|
// other functions that might look at the cake cache,
|
|
// then we'd probably need a GMutex here as well.
|
|
baker_add_cake_to_cache (baker, cake);
|
|
g_task_return_pointer (task, cake, g_object_unref);
|
|
}
|
|
}
|
|
|
|
void
|
|
baker_bake_cake_async (Baker *self,
|
|
guint radius,
|
|
CakeFlavor flavor,
|
|
CakeFrostingType frosting,
|
|
const char *message,
|
|
GCancellable *cancellable,
|
|
GAsyncReadyCallback callback,
|
|
gpointer user_data)
|
|
{
|
|
CakeData *cake_data;
|
|
GTask *task;
|
|
|
|
cake_data = g_slice_new (CakeData);
|
|
|
|
...
|
|
|
|
task = g_task_new (self, cancellable, callback, user_data);
|
|
g_task_set_task_data (task, cake_data, (GDestroyNotify) cake_data_free);
|
|
g_task_set_return_on_cancel (task, TRUE);
|
|
g_task_run_in_thread (task, bake_cake_thread);
|
|
}
|
|
|
|
Cake *
|
|
baker_bake_cake_sync (Baker *self,
|
|
guint radius,
|
|
CakeFlavor flavor,
|
|
CakeFrostingType frosting,
|
|
const char *message,
|
|
GCancellable *cancellable,
|
|
GError **error)
|
|
{
|
|
CakeData *cake_data;
|
|
GTask *task;
|
|
Cake *cake;
|
|
|
|
cake_data = g_slice_new (CakeData);
|
|
|
|
...
|
|
|
|
task = g_task_new (self, cancellable, NULL, NULL);
|
|
g_task_set_task_data (task, cake_data, (GDestroyNotify) cake_data_free);
|
|
g_task_set_return_on_cancel (task, TRUE);
|
|
g_task_run_in_thread_sync (task, bake_cake_thread);
|
|
|
|
cake = g_task_propagate_pointer (task, error);
|
|
g_object_unref (task);
|
|
return cake;
|
|
}
|
|
]|
|
|
|
|
## Porting from GSimpleAsyncResult
|
|
|
|
#GTask's API attempts to be simpler than #GSimpleAsyncResult's
|
|
in several ways:
|
|
- You can save task-specific data with g_task_set_task_data(), and
|
|
retrieve it later with g_task_get_task_data(). This replaces the
|
|
abuse of g_simple_async_result_set_op_res_gpointer() for the same
|
|
purpose with #GSimpleAsyncResult.
|
|
- In addition to the task data, #GTask also keeps track of the
|
|
[priority][io-priority], #GCancellable, and
|
|
#GMainContext associated with the task, so tasks that consist of
|
|
a chain of simpler asynchronous operations will have easy access
|
|
to those values when starting each sub-task.
|
|
- g_task_return_error_if_cancelled() provides simplified
|
|
handling for cancellation. In addition, cancellation
|
|
overrides any other #GTask return value by default, like
|
|
#GSimpleAsyncResult does when
|
|
g_simple_async_result_set_check_cancellable() is called.
|
|
(You can use g_task_set_check_cancellable() to turn off that
|
|
behavior.) On the other hand, g_task_run_in_thread()
|
|
guarantees that it will always run your
|
|
`task_func`, even if the task's #GCancellable
|
|
is already cancelled before the task gets a chance to run;
|
|
you can start your `task_func` with a
|
|
g_task_return_error_if_cancelled() check if you need the
|
|
old behavior.
|
|
- The "return" methods (eg, g_task_return_pointer())
|
|
automatically cause the task to be "completed" as well, and
|
|
there is no need to worry about the "complete" vs "complete
|
|
in idle" distinction. (#GTask automatically figures out
|
|
whether the task's callback can be invoked directly, or
|
|
if it needs to be sent to another #GMainContext, or delayed
|
|
until the next iteration of the current #GMainContext.)
|
|
- The "finish" functions for #GTask based operations are generally
|
|
much simpler than #GSimpleAsyncResult ones, normally consisting
|
|
of only a single call to g_task_propagate_pointer() or the like.
|
|
Since g_task_propagate_pointer() "steals" the return value from
|
|
the #GTask, it is not necessary to juggle pointers around to
|
|
prevent it from being freed twice.
|
|
- With #GSimpleAsyncResult, it was common to call
|
|
g_simple_async_result_propagate_error() from the
|
|
`_finish()` wrapper function, and have
|
|
virtual method implementations only deal with successful
|
|
returns. This behavior is deprecated, because it makes it
|
|
difficult for a subclass to chain to a parent class's async
|
|
methods. Instead, the wrapper function should just be a
|
|
simple wrapper, and the virtual method should call an
|
|
appropriate `g_task_propagate_` function.
|
|
Note that wrapper methods can now use
|
|
g_async_result_legacy_propagate_error() to do old-style
|
|
#GSimpleAsyncResult error-returning behavior, and
|
|
g_async_result_is_tagged() to check if a result is tagged as
|
|
having come from the `_async()` wrapper
|
|
function (for "short-circuit" results, such as when passing
|
|
0 to g_input_stream_read_async()).</doc>
|
|
<source-position filename="gtask.h" line="37"/>
|
|
<implements name="AsyncResult"/>
|
|
<constructor name="new" c:identifier="g_task_new" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37961">Creates a #GTask acting on @source_object, which will eventually be
|
|
used to invoke @callback in the current
|
|
[thread-default main context][g-main-context-push-thread-default].
|
|
|
|
Call this in the "start" method of your asynchronous method, and
|
|
pass the #GTask around throughout the asynchronous operation. You
|
|
can use g_task_set_task_data() to attach task-specific data to the
|
|
object, which you can retrieve later via g_task_get_task_data().
|
|
|
|
By default, if @cancellable is cancelled, then the return value of
|
|
the task will always be %G_IO_ERROR_CANCELLED, even if the task had
|
|
already completed before the cancellation. This allows for
|
|
simplified handling in cases where cancellation may imply that
|
|
other objects that the task depends on have been destroyed. If you
|
|
do not want this behavior, you can use
|
|
g_task_set_check_cancellable() to change it.</doc>
|
|
<source-position filename="gtask.h" line="43"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37986">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37963">the #GObject that owns
|
|
this task, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37965">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37966">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37967">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="is_valid" c:identifier="g_task_is_valid" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37945">Checks that @result is a #GTask, and that @source_object is its
|
|
source object (or that @source_object is %NULL and @result has no
|
|
source object). This can be used in g_return_if_fail() checks.</doc>
|
|
<source-position filename="gtask.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37955">%TRUE if @result and @source_object are valid, %FALSE
|
|
if not</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37947">A #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37948">the source object
|
|
expected to be associated with the task</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="report_error" c:identifier="g_task_report_error" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38046">Creates a #GTask and then immediately calls g_task_return_error()
|
|
on it. Use this in the wrapper function of an asynchronous method
|
|
when you want to avoid even calling the virtual method. You can
|
|
then use g_async_result_is_tagged() in the finish method wrapper to
|
|
check if the result there is tagged as having been created by the
|
|
wrapper method, and deal with it appropriately if so.
|
|
|
|
See also g_task_report_new_error().</doc>
|
|
<source-position filename="gtask.h" line="49"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38048">the #GObject that owns
|
|
this task, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38050">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38051">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38052">an opaque pointer indicating the source of this task</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38053">error to report</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="report_new_error" c:identifier="g_task_report_new_error" version="2.36" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38068">Creates a #GTask and then immediately calls
|
|
g_task_return_new_error() on it. Use this in the wrapper function
|
|
of an asynchronous method when you want to avoid even calling the
|
|
virtual method. You can then use g_async_result_is_tagged() in the
|
|
finish method wrapper to check if the result there is tagged as
|
|
having been created by the wrapper method, and deal with it
|
|
appropriately if so.
|
|
|
|
See also g_task_report_error().</doc>
|
|
<source-position filename="gtask.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="source_object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38070">the #GObject that owns
|
|
this task, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38072">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="callback_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38073">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38074">an opaque pointer indicating the source of this task</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38075">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38076">an error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38077">a string with format characters.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38078">a list of values to insert into @format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<method name="attach_source" c:identifier="g_task_attach_source" version="2.36" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37795">A utility function for dealing with async operations where you need
|
|
to wait for a #GSource to trigger. Attaches @source to @task's
|
|
#GMainContext with @task's [priority][io-priority], and sets @source's
|
|
callback to @callback, with @task as the callback's `user_data`.
|
|
|
|
It will set the @source’s name to the task’s name (as set with
|
|
g_task_set_name()), if one has been set.
|
|
|
|
This takes a reference on @task until @source is destroyed.</doc>
|
|
<source-position filename="gtask.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37797">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37798">the source to attach</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37799">the callback to invoke when @source triggers</doc>
|
|
<type name="GLib.SourceFunc" c:type="GSourceFunc"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_cancellable" c:identifier="g_task_get_cancellable" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37815">Gets @task's #GCancellable</doc>
|
|
<source-position filename="gtask.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37821">@task's #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37817">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_check_cancellable" c:identifier="g_task_get_check_cancellable" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37826">Gets @task's check-cancellable flag. See
|
|
g_task_set_check_cancellable() for more details.</doc>
|
|
<source-position filename="gtask.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37828">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_completed" c:identifier="g_task_get_completed" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37837">Gets the value of #GTask:completed. This changes from %FALSE to %TRUE after
|
|
the task’s callback is invoked, and will return %FALSE if called from inside
|
|
the callback.</doc>
|
|
<source-position filename="gtask.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37845">%TRUE if the task has completed, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37839">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_context" c:identifier="g_task_get_context" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37850">Gets the #GMainContext that @task will return its result in (that
|
|
is, the context that was the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
at the point when @task was created).
|
|
|
|
This will always return a non-%NULL value, even if the task's
|
|
context is the default #GMainContext.</doc>
|
|
<source-position filename="gtask.h" line="88"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37862">@task's #GMainContext</doc>
|
|
<type name="GLib.MainContext" c:type="GMainContext*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37852">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_task_get_name" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37867">Gets @task’s name. See g_task_set_name().</doc>
|
|
<source-position filename="gtask.h" line="96"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37873">@task’s name, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37869">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_priority" c:identifier="g_task_get_priority" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37878">Gets @task's priority</doc>
|
|
<source-position filename="gtask.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37884">@task's priority</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37880">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_return_on_cancel" c:identifier="g_task_get_return_on_cancel" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37889">Gets @task's return-on-cancel flag. See
|
|
g_task_set_return_on_cancel() for more details.</doc>
|
|
<source-position filename="gtask.h" line="117"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37891">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_source_object" c:identifier="g_task_get_source_object" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37900">Gets the source object from @task. Like
|
|
g_async_result_get_source_object(), but does not ref the object.</doc>
|
|
<source-position filename="gtask.h" line="82"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37907">@task's source object, or %NULL</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37902">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_source_tag" c:identifier="g_task_get_source_tag" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37912">Gets @task's source tag. See g_task_set_source_tag().</doc>
|
|
<source-position filename="gtask.h" line="94"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37918">@task's source tag</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37914">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_task_data" c:identifier="g_task_get_task_data" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37923">Gets @task's `task_data`.</doc>
|
|
<source-position filename="gtask.h" line="84"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37929">@task's `task_data`.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37925">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="had_error" c:identifier="g_task_had_error" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37934">Tests if @task resulted in an error.</doc>
|
|
<source-position filename="gtask.h" line="159"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37940">%TRUE if the task resulted in an error, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37936">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="propagate_boolean" c:identifier="g_task_propagate_boolean" version="2.36" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37991">Gets the result of @task as a #gboolean.
|
|
|
|
If the task resulted in an error, or was cancelled, then this will
|
|
instead return %FALSE and set @error.
|
|
|
|
Since this method transfers ownership of the return value (or
|
|
error) to the caller, you may only call it once.</doc>
|
|
<source-position filename="gtask.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38004">the task result, or %FALSE on error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="37993">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="propagate_int" c:identifier="g_task_propagate_int" version="2.36" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38009">Gets the result of @task as an integer (#gssize).
|
|
|
|
If the task resulted in an error, or was cancelled, then this will
|
|
instead return -1 and set @error.
|
|
|
|
Since this method transfers ownership of the return value (or
|
|
error) to the caller, you may only call it once.</doc>
|
|
<source-position filename="gtask.h" line="156"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38022">the task result, or -1 on error</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38011">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="propagate_pointer" c:identifier="g_task_propagate_pointer" version="2.36" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38027">Gets the result of @task as a pointer, and transfers ownership
|
|
of that value to the caller.
|
|
|
|
If the task resulted in an error, or was cancelled, then this will
|
|
instead return %NULL and set @error.
|
|
|
|
Since this method transfers ownership of the return value (or
|
|
error) to the caller, you may only call it once.</doc>
|
|
<source-position filename="gtask.h" line="150"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38041">the task result, or %NULL on error</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38029">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_boolean" c:identifier="g_task_return_boolean" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38094">Sets @task's result to @result and completes the task (see
|
|
g_task_return_pointer() for more discussion of exactly what this
|
|
means).</doc>
|
|
<source-position filename="gtask.h" line="130"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38096">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38097">the #gboolean result of a task function.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_error" c:identifier="g_task_return_error" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38107">Sets @task's result to @error (which @task assumes ownership of)
|
|
and completes the task (see g_task_return_pointer() for more
|
|
discussion of exactly what this means).
|
|
|
|
Note that since the task takes ownership of @error, and since the
|
|
task may be completed before returning from g_task_return_error(),
|
|
you cannot assume that @error is still valid after calling this.
|
|
Call g_error_copy() on the error if you need to keep a local copy
|
|
as well.
|
|
|
|
See also g_task_return_new_error().</doc>
|
|
<source-position filename="gtask.h" line="137"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38109">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="error" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38110">the #GError result of a task function.</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_error_if_cancelled" c:identifier="g_task_return_error_if_cancelled" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38128">Checks if @task's #GCancellable has been cancelled, and if so, sets
|
|
@task's error accordingly and completes the task (see
|
|
g_task_return_pointer() for more discussion of exactly what this
|
|
means).</doc>
|
|
<source-position filename="gtask.h" line="147"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38137">%TRUE if @task has been cancelled, %FALSE if not</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38130">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_int" c:identifier="g_task_return_int" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38142">Sets @task's result to @result and completes the task (see
|
|
g_task_return_pointer() for more discussion of exactly what this
|
|
means).</doc>
|
|
<source-position filename="gtask.h" line="133"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38144">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38145">the integer (#gssize) result of a task function.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_new_error" c:identifier="g_task_return_new_error" version="2.36" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38155">Sets @task's result to a new #GError created from @domain, @code,
|
|
@format, and the remaining arguments, and completes the task (see
|
|
g_task_return_pointer() for more discussion of exactly what this
|
|
means).
|
|
|
|
See also g_task_return_error().</doc>
|
|
<source-position filename="gtask.h" line="140"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38157">a #GTask.</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38158">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38159">an error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38160">a string with format characters.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38161">a list of values to insert into @format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="return_pointer" c:identifier="g_task_return_pointer" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38174">Sets @task's result to @result and completes the task. If @result
|
|
is not %NULL, then @result_destroy will be used to free @result if
|
|
the caller does not take ownership of it with
|
|
g_task_propagate_pointer().
|
|
|
|
"Completes the task" means that for an ordinary asynchronous task
|
|
it will either invoke the task's callback, or else queue that
|
|
callback to be invoked in the proper #GMainContext, or in the next
|
|
iteration of the current #GMainContext. For a task run via
|
|
g_task_run_in_thread() or g_task_run_in_thread_sync(), calling this
|
|
method will save @result to be returned to the caller later, but
|
|
the task will not actually be completed until the #GTaskThreadFunc
|
|
exits.
|
|
|
|
Note that since the task may be completed before returning from
|
|
g_task_return_pointer(), you cannot assume that @result is still
|
|
valid after calling this, unless you are still holding another
|
|
reference on it.</doc>
|
|
<source-position filename="gtask.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38176">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="full" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38177">the pointer result of a task
|
|
function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="result_destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38179">a #GDestroyNotify function.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="run_in_thread" c:identifier="g_task_run_in_thread" version="2.36" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38204">Runs @task_func in another thread. When @task_func returns, @task's
|
|
#GAsyncReadyCallback will be invoked in @task's #GMainContext.
|
|
|
|
This takes a ref on @task until the task completes.
|
|
|
|
See #GTaskThreadFunc for more details about how @task_func is handled.
|
|
|
|
Although GLib currently rate-limits the tasks queued via
|
|
g_task_run_in_thread(), you should not assume that it will always
|
|
do this. If you have a very large number of tasks to run, but don't
|
|
want them to all run at once, you should only queue a limited
|
|
number of them at a time.</doc>
|
|
<source-position filename="gtask.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38206">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="task_func" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38207">a #GTaskThreadFunc</doc>
|
|
<type name="TaskThreadFunc" c:type="GTaskThreadFunc"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="run_in_thread_sync" c:identifier="g_task_run_in_thread_sync" version="2.36" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38226">Runs @task_func in another thread, and waits for it to return or be
|
|
cancelled. You can use g_task_propagate_pointer(), etc, afterward
|
|
to get the result of @task_func.
|
|
|
|
See #GTaskThreadFunc for more details about how @task_func is handled.
|
|
|
|
Normally this is used with tasks created with a %NULL
|
|
`callback`, but note that even if the task does
|
|
have a callback, it will not be invoked when @task_func returns.
|
|
#GTask:completed will be set to %TRUE just before this function returns.
|
|
|
|
Although GLib currently rate-limits the tasks queued via
|
|
g_task_run_in_thread_sync(), you should not assume that it will
|
|
always do this. If you have a very large number of tasks to run,
|
|
but don't want them to all run at once, you should only queue a
|
|
limited number of them at a time.</doc>
|
|
<source-position filename="gtask.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38228">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="task_func" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38229">a #GTaskThreadFunc</doc>
|
|
<type name="TaskThreadFunc" c:type="GTaskThreadFunc"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_check_cancellable" c:identifier="g_task_set_check_cancellable" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38252">Sets or clears @task's check-cancellable flag. If this is %TRUE
|
|
(the default), then g_task_propagate_pointer(), etc, and
|
|
g_task_had_error() will check the task's #GCancellable first, and
|
|
if it has been cancelled, then they will consider the task to have
|
|
returned an "Operation was cancelled" error
|
|
(%G_IO_ERROR_CANCELLED), regardless of any other error or return
|
|
value the task may have had.
|
|
|
|
If @check_cancellable is %FALSE, then the #GTask will not check the
|
|
cancellable itself, and it is up to @task's owner to do this (eg,
|
|
via g_task_return_error_if_cancelled()).
|
|
|
|
If you are using g_task_set_return_on_cancel() as well, then
|
|
you must leave check-cancellable set %TRUE.</doc>
|
|
<source-position filename="gtask.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38254">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="check_cancellable" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38255">whether #GTask will check the state of
|
|
its #GCancellable for you.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_name" c:identifier="g_task_set_name" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38277">Sets @task’s name, used in debugging and profiling. The name defaults to
|
|
%NULL.
|
|
|
|
The task name should describe in a human readable way what the task does.
|
|
For example, ‘Open file’ or ‘Connect to network host’. It is used to set the
|
|
name of the #GSource used for idle completion of the task.
|
|
|
|
This function may only be called before the @task is first used in a thread
|
|
other than the one it was constructed in.</doc>
|
|
<source-position filename="gtask.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38279">a #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38280">a human readable name for the task, or %NULL to unset it</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_priority" c:identifier="g_task_set_priority" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38296">Sets @task's priority. If you do not call this, it will default to
|
|
%G_PRIORITY_DEFAULT.
|
|
|
|
This will affect the priority of #GSources created with
|
|
g_task_attach_source() and the scheduling of tasks run in threads,
|
|
and can also be explicitly retrieved later via
|
|
g_task_get_priority().</doc>
|
|
<source-position filename="gtask.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38298">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38299">the [priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_return_on_cancel" c:identifier="g_task_set_return_on_cancel" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38313">Sets or clears @task's return-on-cancel flag. This is only
|
|
meaningful for tasks run via g_task_run_in_thread() or
|
|
g_task_run_in_thread_sync().
|
|
|
|
If @return_on_cancel is %TRUE, then cancelling @task's
|
|
#GCancellable will immediately cause it to return, as though the
|
|
task's #GTaskThreadFunc had called
|
|
g_task_return_error_if_cancelled() and then returned.
|
|
|
|
This allows you to create a cancellable wrapper around an
|
|
uninterruptable function. The #GTaskThreadFunc just needs to be
|
|
careful that it does not modify any externally-visible state after
|
|
it has been cancelled. To do that, the thread should call
|
|
g_task_set_return_on_cancel() again to (atomically) set
|
|
return-on-cancel %FALSE before making externally-visible changes;
|
|
if the task gets cancelled before the return-on-cancel flag could
|
|
be changed, g_task_set_return_on_cancel() will indicate this by
|
|
returning %FALSE.
|
|
|
|
You can disable and re-enable this flag multiple times if you wish.
|
|
If the task's #GCancellable is cancelled while return-on-cancel is
|
|
%FALSE, then calling g_task_set_return_on_cancel() to set it %TRUE
|
|
again will cause the task to be cancelled at that point.
|
|
|
|
If the task's #GCancellable is already cancelled before you call
|
|
g_task_run_in_thread()/g_task_run_in_thread_sync(), then the
|
|
#GTaskThreadFunc will still be run (for consistency), but the task
|
|
will also be completed right away.</doc>
|
|
<source-position filename="gtask.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38348">%TRUE if @task's return-on-cancel flag was changed to
|
|
match @return_on_cancel. %FALSE if @task has already been
|
|
cancelled.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38315">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="return_on_cancel" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38316">whether the task returns automatically when
|
|
it is cancelled.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_source_tag" c:identifier="g_task_set_source_tag" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38355">Sets @task's source tag. You can use this to tag a task return
|
|
value with a particular pointer (usually a pointer to the function
|
|
doing the tagging) and then later check it using
|
|
g_task_get_source_tag() (or g_async_result_is_tagged()) in the
|
|
task's "finish" function, to figure out if the response came from a
|
|
particular place.</doc>
|
|
<source-position filename="gtask.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38357">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="source_tag" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38358">an opaque pointer indicating the source of this task</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_task_data" c:identifier="g_task_set_task_data" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38371">Sets @task's task data (freeing the existing task data, if any).</doc>
|
|
<source-position filename="gtask.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38373">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</instance-parameter>
|
|
<parameter name="task_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38374">task-specific data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="task_data_destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38375">#GDestroyNotify for @task_data</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="completed" version="2.44" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3421">Whether the task has completed, meaning its callback (if set) has been
|
|
invoked. This can only happen after g_task_return_pointer(),
|
|
g_task_return_error() or one of the other return functions have been called
|
|
on the task.
|
|
|
|
This property is guaranteed to change from %FALSE to %TRUE exactly once.
|
|
|
|
The #GObject::notify signal for this change is emitted in the same main
|
|
context as the task’s callback, immediately after that callback is invoked.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
</class>
|
|
<record name="TaskClass" c:type="GTaskClass" disguised="1" glib:is-gtype-struct-for="Task">
|
|
<source-position filename="gtask.h" line="37"/>
|
|
</record>
|
|
<callback name="TaskThreadFunc" c:type="GTaskThreadFunc" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3438">The prototype for a task function to be run in a thread via
|
|
g_task_run_in_thread() or g_task_run_in_thread_sync().
|
|
|
|
If the return-on-cancel flag is set on @task, and @cancellable gets
|
|
cancelled, then the #GTask will be completed immediately (as though
|
|
g_task_return_error_if_cancelled() had been called), without
|
|
waiting for the task function to complete. However, the task
|
|
function will continue running in its thread in the background. The
|
|
function therefore needs to be careful about how it uses
|
|
externally-visible state in this case. See
|
|
g_task_set_return_on_cancel() for more details.
|
|
|
|
Other than in that case, @task will be completed when the
|
|
#GTaskThreadFunc returns, not when it calls a
|
|
`g_task_return_` function.</doc>
|
|
<source-position filename="gtask.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="task" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3440">the #GTask</doc>
|
|
<type name="Task" c:type="GTask*"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3441">@task's source object</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="task_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3442">@task's task data</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3443">@task's #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<class name="TcpConnection" c:symbol-prefix="tcp_connection" c:type="GTcpConnection" version="2.22" parent="SocketConnection" glib:type-name="GTcpConnection" glib:get-type="g_tcp_connection_get_type" glib:type-struct="TcpConnectionClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9223">This is the subclass of #GSocketConnection that is created
|
|
for TCP/IP sockets.</doc>
|
|
<source-position filename="gtcpconnection.h" line="50"/>
|
|
<method name="get_graceful_disconnect" c:identifier="g_tcp_connection_get_graceful_disconnect" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38383">Checks if graceful disconnects are used. See
|
|
g_tcp_connection_set_graceful_disconnect().</doc>
|
|
<source-position filename="gtcpconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38390">%TRUE if graceful disconnect is used on close, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38385">a #GTcpConnection</doc>
|
|
<type name="TcpConnection" c:type="GTcpConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_graceful_disconnect" c:identifier="g_tcp_connection_set_graceful_disconnect" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38395">This enables graceful disconnects on close. A graceful disconnect
|
|
means that we signal the receiving end that the connection is terminated
|
|
and wait for it to close the connection before closing the connection.
|
|
|
|
A graceful disconnect means that we can be sure that we successfully sent
|
|
all the outstanding data to the other end, or get an error reported.
|
|
However, it also means we have to wait for all the data to reach the
|
|
other side and for it to acknowledge this by closing the socket, which may
|
|
take a while. For this reason it is disabled by default.</doc>
|
|
<source-position filename="gtcpconnection.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38397">a #GTcpConnection</doc>
|
|
<type name="TcpConnection" c:type="GTcpConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="graceful_disconnect" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38398">Whether to do graceful disconnects or not</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="graceful-disconnect" writable="1" transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="SocketConnection" c:type="GSocketConnection"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="TcpConnectionPrivate" c:type="GTcpConnectionPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="TcpConnectionClass" c:type="GTcpConnectionClass" glib:is-gtype-struct-for="TcpConnection">
|
|
<source-position filename="gtcpconnection.h" line="50"/>
|
|
<field name="parent_class">
|
|
<type name="SocketConnectionClass" c:type="GSocketConnectionClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="TcpConnectionPrivate" c:type="GTcpConnectionPrivate" disguised="1">
|
|
<source-position filename="gtcpconnection.h" line="44"/>
|
|
</record>
|
|
<class name="TcpWrapperConnection" c:symbol-prefix="tcp_wrapper_connection" c:type="GTcpWrapperConnection" version="2.28" parent="TcpConnection" glib:type-name="GTcpWrapperConnection" glib:get-type="g_tcp_wrapper_connection_get_type" glib:type-struct="TcpWrapperConnectionClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9237">A #GTcpWrapperConnection can be used to wrap a #GIOStream that is
|
|
based on a #GSocket, but which is not actually a
|
|
#GSocketConnection. This is used by #GSocketClient so that it can
|
|
always return a #GSocketConnection, even when the connection it has
|
|
actually created is not directly a #GSocketConnection.</doc>
|
|
<source-position filename="gtcpwrapperconnection.h" line="50"/>
|
|
<constructor name="new" c:identifier="g_tcp_wrapper_connection_new" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38424">Wraps @base_io_stream and @socket together as a #GSocketConnection.</doc>
|
|
<source-position filename="gtcpwrapperconnection.h" line="62"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38431">the new #GSocketConnection.</doc>
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_io_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38426">the #GIOStream to wrap</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38427">the #GSocket associated with @base_io_stream</doc>
|
|
<type name="Socket" c:type="GSocket*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_base_io_stream" c:identifier="g_tcp_wrapper_connection_get_base_io_stream">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38414">Get's @conn's base #GIOStream</doc>
|
|
<source-position filename="gtcpwrapperconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38420">@conn's base #GIOStream</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38416">a #GTcpWrapperConnection</doc>
|
|
<type name="TcpWrapperConnection" c:type="GTcpWrapperConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="base-io-stream" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="IOStream"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="TcpConnection" c:type="GTcpConnection"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="TcpWrapperConnectionPrivate" c:type="GTcpWrapperConnectionPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="TcpWrapperConnectionClass" c:type="GTcpWrapperConnectionClass" glib:is-gtype-struct-for="TcpWrapperConnection">
|
|
<source-position filename="gtcpwrapperconnection.h" line="50"/>
|
|
<field name="parent_class">
|
|
<type name="TcpConnectionClass" c:type="GTcpConnectionClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="TcpWrapperConnectionPrivate" c:type="GTcpWrapperConnectionPrivate" disguised="1">
|
|
<source-position filename="gtcpwrapperconnection.h" line="44"/>
|
|
</record>
|
|
<class name="TestDBus" c:symbol-prefix="test_dbus" c:type="GTestDBus" version="2.34" parent="GObject.Object" glib:type-name="GTestDBus" glib:get-type="g_test_dbus_get_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9255">A helper class for testing code which uses D-Bus without touching the user's
|
|
session bus.
|
|
|
|
Note that #GTestDBus modifies the user’s environment, calling setenv().
|
|
This is not thread-safe, so all #GTestDBus calls should be completed before
|
|
threads are spawned, or should have appropriate locking to ensure no access
|
|
conflicts to environment variables shared between #GTestDBus and other
|
|
threads.
|
|
|
|
## Creating unit tests using GTestDBus
|
|
|
|
Testing of D-Bus services can be tricky because normally we only ever run
|
|
D-Bus services over an existing instance of the D-Bus daemon thus we
|
|
usually don't activate D-Bus services that are not yet installed into the
|
|
target system. The #GTestDBus object makes this easier for us by taking care
|
|
of the lower level tasks such as running a private D-Bus daemon and looking
|
|
up uninstalled services in customizable locations, typically in your source
|
|
code tree.
|
|
|
|
The first thing you will need is a separate service description file for the
|
|
D-Bus daemon. Typically a `services` subdirectory of your `tests` directory
|
|
is a good place to put this file.
|
|
|
|
The service file should list your service along with an absolute path to the
|
|
uninstalled service executable in your source tree. Using autotools we would
|
|
achieve this by adding a file such as `my-server.service.in` in the services
|
|
directory and have it processed by configure.
|
|
|[
|
|
[D-BUS Service]
|
|
Name=org.gtk.GDBus.Examples.ObjectManager
|
|
Exec=@abs_top_builddir@/gio/tests/gdbus-example-objectmanager-server
|
|
]|
|
|
You will also need to indicate this service directory in your test
|
|
fixtures, so you will need to pass the path while compiling your
|
|
test cases. Typically this is done with autotools with an added
|
|
preprocessor flag specified to compile your tests such as:
|
|
|[
|
|
-DTEST_SERVICES=\""$(abs_top_builddir)/tests/services"\"
|
|
]|
|
|
Once you have a service definition file which is local to your source tree,
|
|
you can proceed to set up a GTest fixture using the #GTestDBus scaffolding.
|
|
|
|
An example of a test fixture for D-Bus services can be found
|
|
here:
|
|
[gdbus-test-fixture.c](https://git.gnome.org/browse/glib/tree/gio/tests/gdbus-test-fixture.c)
|
|
|
|
Note that these examples only deal with isolating the D-Bus aspect of your
|
|
service. To successfully run isolated unit tests on your service you may need
|
|
some additional modifications to your test case fixture. For example; if your
|
|
service uses GSettings and installs a schema then it is important that your test service
|
|
not load the schema in the ordinary installed location (chances are that your service
|
|
and schema files are not yet installed, or worse; there is an older version of the
|
|
schema file sitting in the install location).
|
|
|
|
Most of the time we can work around these obstacles using the
|
|
environment. Since the environment is inherited by the D-Bus daemon
|
|
created by #GTestDBus and then in turn inherited by any services the
|
|
D-Bus daemon activates, using the setup routine for your fixture is
|
|
a practical place to help sandbox your runtime environment. For the
|
|
rather typical GSettings case we can work around this by setting
|
|
`GSETTINGS_SCHEMA_DIR` to the in tree directory holding your schemas
|
|
in the above fixture_setup() routine.
|
|
|
|
The GSettings schemas need to be locally pre-compiled for this to work. This can be achieved
|
|
by compiling the schemas locally as a step before running test cases, an autotools setup might
|
|
do the following in the directory holding schemas:
|
|
|[
|
|
all-am:
|
|
$(GLIB_COMPILE_SCHEMAS) .
|
|
|
|
CLEANFILES += gschemas.compiled
|
|
]|</doc>
|
|
<constructor name="new" c:identifier="g_test_dbus_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38480">Create a new #GTestDBus object.</doc>
|
|
<source-position filename="gtestdbus.h" line="46"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38486">a new #GTestDBus.</doc>
|
|
<type name="TestDBus" c:type="GTestDBus*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38482">a #GTestDBusFlags</doc>
|
|
<type name="TestDBusFlags" c:type="GTestDBusFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="unset" c:identifier="g_test_dbus_unset">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38503">Unset DISPLAY and DBUS_SESSION_BUS_ADDRESS env variables to ensure the test
|
|
won't use user's session bus.
|
|
|
|
This is useful for unit tests that want to verify behaviour when no session
|
|
bus is running. It is not necessary to call this if unit test already calls
|
|
g_test_dbus_up() before acquiring the session bus.</doc>
|
|
<source-position filename="gtestdbus.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</function>
|
|
<method name="add_service_dir" c:identifier="g_test_dbus_add_service_dir">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38436">Add a path where dbus-daemon will look up .service files. This can't be
|
|
called after g_test_dbus_up().</doc>
|
|
<source-position filename="gtestdbus.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38438">a #GTestDBus</doc>
|
|
<type name="TestDBus" c:type="GTestDBus*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38439">path to a directory containing .service files</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="down" c:identifier="g_test_dbus_down">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38446">Stop the session bus started by g_test_dbus_up().
|
|
|
|
This will wait for the singleton returned by g_bus_get() or g_bus_get_sync()
|
|
to be destroyed. This is done to ensure that the next unit test won't get a
|
|
leaked singleton from this test.</doc>
|
|
<source-position filename="gtestdbus.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38448">a #GTestDBus</doc>
|
|
<type name="TestDBus" c:type="GTestDBus*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_bus_address" c:identifier="g_test_dbus_get_bus_address">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38458">Get the address on which dbus-daemon is running. If g_test_dbus_up() has not
|
|
been called yet, %NULL is returned. This can be used with
|
|
g_dbus_connection_new_for_address().</doc>
|
|
<source-position filename="gtestdbus.h" line="52"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38466">the address of the bus, or %NULL.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38460">a #GTestDBus</doc>
|
|
<type name="TestDBus" c:type="GTestDBus*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_test_dbus_get_flags">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38470">Get the flags of the #GTestDBus object.</doc>
|
|
<source-position filename="gtestdbus.h" line="49"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38476">the value of #GTestDBus:flags property</doc>
|
|
<type name="TestDBusFlags" c:type="GTestDBusFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38472">a #GTestDBus</doc>
|
|
<type name="TestDBus" c:type="GTestDBus*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="stop" c:identifier="g_test_dbus_stop">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38490">Stop the session bus started by g_test_dbus_up().
|
|
|
|
Unlike g_test_dbus_down(), this won't verify the #GDBusConnection
|
|
singleton returned by g_bus_get() or g_bus_get_sync() is destroyed. Unit
|
|
tests wanting to verify behaviour after the session bus has been stopped
|
|
can use this function but should still call g_test_dbus_down() when done.</doc>
|
|
<source-position filename="gtestdbus.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38492">a #GTestDBus</doc>
|
|
<type name="TestDBus" c:type="GTestDBus*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="up" c:identifier="g_test_dbus_up">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38515">Start a dbus-daemon instance and set DBUS_SESSION_BUS_ADDRESS. After this
|
|
call, it is safe for unit tests to start sending messages on the session bus.
|
|
|
|
If this function is called from setup callback of g_test_add(),
|
|
g_test_dbus_down() must be called in its teardown callback.
|
|
|
|
If this function is called from unit test's main(), then g_test_dbus_down()
|
|
must be called after g_test_run().</doc>
|
|
<source-position filename="gtestdbus.h" line="59"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38517">a #GTestDBus</doc>
|
|
<type name="TestDBus" c:type="GTestDBus*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="flags" version="2.34" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3483">#GTestDBusFlags specifying the behaviour of the D-Bus session.</doc>
|
|
<type name="TestDBusFlags"/>
|
|
</property>
|
|
</class>
|
|
<bitfield name="TestDBusFlags" version="2.34" glib:type-name="GTestDBusFlags" glib:get-type="g_test_dbus_flags_get_type" c:type="GTestDBusFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1831">Flags to define future #GTestDBus behaviour.</doc>
|
|
<member name="none" value="0" c:identifier="G_TEST_DBUS_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1833">No flags.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<class name="ThemedIcon" c:symbol-prefix="themed_icon" c:type="GThemedIcon" parent="GObject.Object" glib:type-name="GThemedIcon" glib:get-type="g_themed_icon_get_type" glib:type-struct="ThemedIconClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9335">#GThemedIcon is an implementation of #GIcon that supports icon themes.
|
|
#GThemedIcon contains a list of all of the icons present in an icon
|
|
theme, so that icons can be looked up quickly. #GThemedIcon does
|
|
not provide actual pixmaps for icons, just the icon names.
|
|
Ideally something like gtk_icon_theme_choose_icon() should be used to
|
|
resolve the list of names so that fallback icons work nicely with
|
|
themes that inherit other themes.</doc>
|
|
<source-position filename="gthemedicon.h" line="44"/>
|
|
<implements name="Icon"/>
|
|
<constructor name="new" c:identifier="g_themed_icon_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38552">Creates a new themed icon for @iconname.</doc>
|
|
<source-position filename="gthemedicon.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38558">a new #GThemedIcon.</doc>
|
|
<type name="ThemedIcon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="iconname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38554">a string containing an icon name.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_names" c:identifier="g_themed_icon_new_from_names">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38562">Creates a new themed icon for @iconnames.</doc>
|
|
<source-position filename="gthemedicon.h" line="54"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38570">a new #GThemedIcon</doc>
|
|
<type name="ThemedIcon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="iconnames" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38564">an array of strings containing icon names.</doc>
|
|
<array length="1" zero-terminated="0" c:type="char**">
|
|
<type name="utf8" c:type="char*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38565">the length of the @iconnames array, or -1 if @iconnames is
|
|
%NULL-terminated</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_with_default_fallbacks" c:identifier="g_themed_icon_new_with_default_fallbacks">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38574">Creates a new themed icon for @iconname, and all the names
|
|
that can be created by shortening @iconname at '-' characters.
|
|
|
|
In the following example, @icon1 and @icon2 are equivalent:
|
|
|[<!-- language="C" -->
|
|
const char *names[] = {
|
|
"gnome-dev-cdrom-audio",
|
|
"gnome-dev-cdrom",
|
|
"gnome-dev",
|
|
"gnome"
|
|
};
|
|
|
|
icon1 = g_themed_icon_new_from_names (names, 4);
|
|
icon2 = g_themed_icon_new_with_default_fallbacks ("gnome-dev-cdrom-audio");
|
|
]|</doc>
|
|
<source-position filename="gthemedicon.h" line="52"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38594">a new #GThemedIcon.</doc>
|
|
<type name="ThemedIcon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="iconname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38576">a string containing an icon name</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="append_name" c:identifier="g_themed_icon_append_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38530">Append a name to the list of icons from within @icon.
|
|
|
|
Note that doing so invalidates the hash computed by prior calls
|
|
to g_icon_hash().</doc>
|
|
<source-position filename="gthemedicon.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38532">a #GThemedIcon</doc>
|
|
<type name="ThemedIcon" c:type="GThemedIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="iconname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38533">name of icon to append to list of icons from within @icon.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_names" c:identifier="g_themed_icon_get_names">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38542">Gets the names of icons from within @icon.</doc>
|
|
<source-position filename="gthemedicon.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38548">a list of icon names.</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38544">a #GThemedIcon.</doc>
|
|
<type name="ThemedIcon" c:type="GThemedIcon*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="prepend_name" c:identifier="g_themed_icon_prepend_name" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38598">Prepend a name to the list of icons from within @icon.
|
|
|
|
Note that doing so invalidates the hash computed by prior calls
|
|
to g_icon_hash().</doc>
|
|
<source-position filename="gthemedicon.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38600">a #GThemedIcon</doc>
|
|
<type name="ThemedIcon" c:type="GThemedIcon*"/>
|
|
</instance-parameter>
|
|
<parameter name="iconname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38601">name of icon to prepend to list of icons from within @icon.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="name" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3492">The icon name.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="names" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3499">A %NULL-terminated array of icon names.</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</property>
|
|
<property name="use-default-fallbacks" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3506">Whether to use the default fallbacks found by shortening the icon name
|
|
at '-' characters. If the "names" array has more than one element,
|
|
ignores any past the first.
|
|
|
|
For example, if the icon name was "gnome-dev-cdrom-audio", the array
|
|
would become
|
|
|[<!-- language="C" -->
|
|
{
|
|
"gnome-dev-cdrom-audio",
|
|
"gnome-dev-cdrom",
|
|
"gnome-dev",
|
|
"gnome",
|
|
NULL
|
|
};
|
|
]|</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
</class>
|
|
<record name="ThemedIconClass" c:type="GThemedIconClass" disguised="1" glib:is-gtype-struct-for="ThemedIcon">
|
|
<source-position filename="gthemedicon.h" line="44"/>
|
|
</record>
|
|
<class name="ThreadedSocketService" c:symbol-prefix="threaded_socket_service" c:type="GThreadedSocketService" version="2.22" parent="SocketService" glib:type-name="GThreadedSocketService" glib:get-type="g_threaded_socket_service_get_type" glib:type-struct="ThreadedSocketServiceClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9351">A #GThreadedSocketService is a simple subclass of #GSocketService
|
|
that handles incoming connections by creating a worker thread and
|
|
dispatching the connection to it by emitting the
|
|
#GThreadedSocketService::run signal in the new thread.
|
|
|
|
The signal handler may perform blocking IO and need not return
|
|
until the connection is closed.
|
|
|
|
The service is implemented using a thread pool, so there is a
|
|
limited amount of threads available to serve incoming requests.
|
|
The service automatically stops the #GSocketService from accepting
|
|
new connections when all threads are busy.
|
|
|
|
As with #GSocketService, you may connect to #GThreadedSocketService::run,
|
|
or subclass and override the default handler.</doc>
|
|
<source-position filename="gthreadedsocketservice.h" line="66"/>
|
|
<constructor name="new" c:identifier="g_threaded_socket_service_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38640">Creates a new #GThreadedSocketService with no listeners. Listeners
|
|
must be added with one of the #GSocketListener "add" methods.</doc>
|
|
<source-position filename="gthreadedsocketservice.h" line="77"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38648">a new #GSocketService.</doc>
|
|
<type name="SocketService" c:type="GSocketService*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="max_threads" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38642">the maximal number of threads to execute concurrently
|
|
handling incoming clients, -1 means no limit</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<virtual-method name="run">
|
|
<source-position filename="gthreadedsocketservice.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="service" transfer-ownership="none">
|
|
<type name="ThreadedSocketService" c:type="GThreadedSocketService*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none">
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<property name="max-threads" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="SocketService" c:type="GSocketService"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="ThreadedSocketServicePrivate" c:type="GThreadedSocketServicePrivate*"/>
|
|
</field>
|
|
<glib:signal name="run" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3527">The ::run signal is emitted in a worker thread in response to an
|
|
incoming connection. This thread is dedicated to handling
|
|
@connection and may perform blocking IO. The signal handler need
|
|
not return until the connection is closed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3538">%TRUE to stop further signal handlers from being called</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3530">a new #GSocketConnection object.</doc>
|
|
<type name="SocketConnection"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3531">the source_object passed to g_socket_listener_add_address().</doc>
|
|
<type name="GObject.Object"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="ThreadedSocketServiceClass" c:type="GThreadedSocketServiceClass" glib:is-gtype-struct-for="ThreadedSocketService">
|
|
<source-position filename="gthreadedsocketservice.h" line="66"/>
|
|
<field name="parent_class">
|
|
<type name="SocketServiceClass" c:type="GSocketServiceClass"/>
|
|
</field>
|
|
<field name="run">
|
|
<callback name="run">
|
|
<source-position filename="gthreadedsocketservice.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="service" transfer-ownership="none">
|
|
<type name="ThreadedSocketService" c:type="GThreadedSocketService*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="SocketConnection" c:type="GSocketConnection*"/>
|
|
</parameter>
|
|
<parameter name="source_object" transfer-ownership="none">
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gthreadedsocketservice.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gthreadedsocketservice.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gthreadedsocketservice.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gthreadedsocketservice.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gthreadedsocketservice.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="ThreadedSocketServicePrivate" c:type="GThreadedSocketServicePrivate" disguised="1">
|
|
<source-position filename="gthreadedsocketservice.h" line="49"/>
|
|
</record>
|
|
<enumeration name="TlsAuthenticationMode" version="2.28" glib:type-name="GTlsAuthenticationMode" glib:get-type="g_tls_authentication_mode_get_type" c:type="GTlsAuthenticationMode">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1596">The client authentication mode for a #GTlsServerConnection.</doc>
|
|
<member name="none" value="0" c:identifier="G_TLS_AUTHENTICATION_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1598">client authentication not required</doc>
|
|
</member>
|
|
<member name="requested" value="1" c:identifier="G_TLS_AUTHENTICATION_REQUESTED" glib:nick="requested">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1599">client authentication is requested</doc>
|
|
</member>
|
|
<member name="required" value="2" c:identifier="G_TLS_AUTHENTICATION_REQUIRED" glib:nick="required">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1600">client authentication is required</doc>
|
|
</member>
|
|
</enumeration>
|
|
<interface name="TlsBackend" c:symbol-prefix="tls_backend" c:type="GTlsBackend" version="2.28" glib:type-name="GTlsBackend" glib:get-type="g_tls_backend_get_type" glib:type-struct="TlsBackendInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9413">TLS (Transport Layer Security, aka SSL) and DTLS backend.</doc>
|
|
<source-position filename="gtlsbackend.h" line="78"/>
|
|
<function name="get_default" c:identifier="g_tls_backend_get_default" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38677">Gets the default #GTlsBackend for the system.</doc>
|
|
<source-position filename="gtlsbackend.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38682">a #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="get_default_database" invoker="get_default_database" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38687">Gets the default #GTlsDatabase used to verify TLS connections.</doc>
|
|
<source-position filename="gtlsbackend.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38693">the default database, which should be
|
|
unreffed when done.</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38689">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="supports_dtls" invoker="supports_dtls" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38764">Checks if DTLS is supported. DTLS support may not be available even if TLS
|
|
support is available, and vice-versa.</doc>
|
|
<source-position filename="gtlsbackend.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38771">whether DTLS is supported</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38766">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="supports_tls" invoker="supports_tls" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38776">Checks if TLS is supported; if this returns %FALSE for the default
|
|
#GTlsBackend, it means no "real" TLS backend is available.</doc>
|
|
<source-position filename="gtlsbackend.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38783">whether or not TLS is supported</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38778">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_certificate_type" c:identifier="g_tls_backend_get_certificate_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38653">Gets the #GType of @backend's #GTlsCertificate implementation.</doc>
|
|
<source-position filename="gtlsbackend.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38659">the #GType of @backend's #GTlsCertificate
|
|
implementation.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38655">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_client_connection_type" c:identifier="g_tls_backend_get_client_connection_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38665">Gets the #GType of @backend's #GTlsClientConnection implementation.</doc>
|
|
<source-position filename="gtlsbackend.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38671">the #GType of @backend's #GTlsClientConnection
|
|
implementation.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38667">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_default_database" c:identifier="g_tls_backend_get_default_database" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38687">Gets the default #GTlsDatabase used to verify TLS connections.</doc>
|
|
<source-position filename="gtlsbackend.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38693">the default database, which should be
|
|
unreffed when done.</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38689">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_dtls_client_connection_type" c:identifier="g_tls_backend_get_dtls_client_connection_type" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38699">Gets the #GType of @backend’s #GDtlsClientConnection implementation.</doc>
|
|
<source-position filename="gtlsbackend.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38705">the #GType of @backend’s #GDtlsClientConnection
|
|
implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38701">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_dtls_server_connection_type" c:identifier="g_tls_backend_get_dtls_server_connection_type" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38711">Gets the #GType of @backend’s #GDtlsServerConnection implementation.</doc>
|
|
<source-position filename="gtlsbackend.h" line="109"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38717">the #GType of @backend’s #GDtlsServerConnection
|
|
implementation, or %G_TYPE_INVALID if this backend doesn’t support DTLS.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38713">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_file_database_type" c:identifier="g_tls_backend_get_file_database_type" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38723">Gets the #GType of @backend's #GTlsFileDatabase implementation.</doc>
|
|
<source-position filename="gtlsbackend.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38729">the #GType of backend's #GTlsFileDatabase implementation.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38725">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_server_connection_type" c:identifier="g_tls_backend_get_server_connection_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38734">Gets the #GType of @backend's #GTlsServerConnection implementation.</doc>
|
|
<source-position filename="gtlsbackend.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38740">the #GType of @backend's #GTlsServerConnection
|
|
implementation.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38736">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_default_database" c:identifier="g_tls_backend_set_default_database" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38746">Set the default #GTlsDatabase used to verify TLS connections
|
|
|
|
Any subsequent call to g_tls_backend_get_default_database() will return
|
|
the database set in this call. Existing databases and connections are not
|
|
modified.
|
|
|
|
Setting a %NULL default database will reset to using the system default
|
|
database as if g_tls_backend_set_default_database() had never been called.</doc>
|
|
<source-position filename="gtlsbackend.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38748">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
<parameter name="database" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38749">the #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="supports_dtls" c:identifier="g_tls_backend_supports_dtls" version="2.48">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38764">Checks if DTLS is supported. DTLS support may not be available even if TLS
|
|
support is available, and vice-versa.</doc>
|
|
<source-position filename="gtlsbackend.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38771">whether DTLS is supported</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38766">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="supports_tls" c:identifier="g_tls_backend_supports_tls" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38776">Checks if TLS is supported; if this returns %FALSE for the default
|
|
#GTlsBackend, it means no "real" TLS backend is available.</doc>
|
|
<source-position filename="gtlsbackend.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38783">whether or not TLS is supported</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38778">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</interface>
|
|
<record name="TlsBackendInterface" c:type="GTlsBackendInterface" glib:is-gtype-struct-for="TlsBackend" version="2.28">
|
|
<doc xml:space="preserve" filename="gtlsbackend.h" line="47">Provides an interface for describing TLS-related types.</doc>
|
|
<source-position filename="gtlsbackend.h" line="78"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gtlsbackend.h" line="49">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="supports_tls">
|
|
<callback name="supports_tls">
|
|
<source-position filename="gtlsbackend.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38783">whether or not TLS is supported</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38778">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_certificate_type">
|
|
<callback name="get_certificate_type">
|
|
<source-position filename="gtlsbackend.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="get_client_connection_type">
|
|
<callback name="get_client_connection_type">
|
|
<source-position filename="gtlsbackend.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="get_server_connection_type">
|
|
<callback name="get_server_connection_type">
|
|
<source-position filename="gtlsbackend.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="get_file_database_type">
|
|
<callback name="get_file_database_type">
|
|
<source-position filename="gtlsbackend.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="get_default_database">
|
|
<callback name="get_default_database">
|
|
<source-position filename="gtlsbackend.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38693">the default database, which should be
|
|
unreffed when done.</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38689">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="supports_dtls">
|
|
<callback name="supports_dtls">
|
|
<source-position filename="gtlsbackend.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38771">whether DTLS is supported</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="backend" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38766">the #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_dtls_client_connection_type">
|
|
<callback name="get_dtls_client_connection_type">
|
|
<source-position filename="gtlsbackend.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="get_dtls_server_connection_type">
|
|
<callback name="get_dtls_server_connection_type">
|
|
<source-position filename="gtlsbackend.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="GType" c:type="GType"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="TlsCertificate" c:symbol-prefix="tls_certificate" c:type="GTlsCertificate" version="2.28" parent="GObject.Object" abstract="1" glib:type-name="GTlsCertificate" glib:get-type="g_tls_certificate_get_type" glib:type-struct="TlsCertificateClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9425">A certificate used for TLS authentication and encryption.
|
|
This can represent either a certificate only (eg, the certificate
|
|
received by a client from a server), or the combination of
|
|
a certificate and a private key (which is needed when acting as a
|
|
#GTlsServerConnection).</doc>
|
|
<source-position filename="gtlscertificate.h" line="57"/>
|
|
<constructor name="new_from_file" c:identifier="g_tls_certificate_new_from_file" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38835">Creates a #GTlsCertificate from the PEM-encoded data in @file. The
|
|
returned certificate will be the first certificate found in @file. As
|
|
of GLib 2.44, if @file contains more certificates it will try to load
|
|
a certificate chain. All certificates will be verified in the order
|
|
found (top-level certificate should be the last one in the file) and
|
|
the #GTlsCertificate:issuer property of each certificate will be set
|
|
accordingly if the verification succeeds. If any certificate in the
|
|
chain cannot be verified, the first certificate in the file will
|
|
still be returned.
|
|
|
|
If @file cannot be read or parsed, the function will return %NULL and
|
|
set @error. Otherwise, this behaves like
|
|
g_tls_certificate_new_from_pem().</doc>
|
|
<source-position filename="gtlscertificate.h" line="68"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38854">the new certificate, or %NULL on error</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38837">file containing a PEM-encoded certificate to import</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_files" c:identifier="g_tls_certificate_new_from_files" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38859">Creates a #GTlsCertificate from the PEM-encoded data in @cert_file
|
|
and @key_file. The returned certificate will be the first certificate
|
|
found in @cert_file. As of GLib 2.44, if @cert_file contains more
|
|
certificates it will try to load a certificate chain. All
|
|
certificates will be verified in the order found (top-level
|
|
certificate should be the last one in the file) and the
|
|
#GTlsCertificate:issuer property of each certificate will be set
|
|
accordingly if the verification succeeds. If any certificate in the
|
|
chain cannot be verified, the first certificate in the file will
|
|
still be returned.
|
|
|
|
If either file cannot be read or parsed, the function will return
|
|
%NULL and set @error. Otherwise, this behaves like
|
|
g_tls_certificate_new_from_pem().</doc>
|
|
<source-position filename="gtlscertificate.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38882">the new certificate, or %NULL on error</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="cert_file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38861">file containing one or more PEM-encoded
|
|
certificates to import</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="key_file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38863">file containing a PEM-encoded private key
|
|
to import</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_from_pem" c:identifier="g_tls_certificate_new_from_pem" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38887">Creates a #GTlsCertificate from the PEM-encoded data in @data. If
|
|
@data includes both a certificate and a private key, then the
|
|
returned certificate will include the private key data as well. (See
|
|
the #GTlsCertificate:private-key-pem property for information about
|
|
supported formats.)
|
|
|
|
The returned certificate will be the first certificate found in
|
|
@data. As of GLib 2.44, if @data contains more certificates it will
|
|
try to load a certificate chain. All certificates will be verified in
|
|
the order found (top-level certificate should be the last one in the
|
|
file) and the #GTlsCertificate:issuer property of each certificate
|
|
will be set accordingly if the verification succeeds. If any
|
|
certificate in the chain cannot be verified, the first certificate in
|
|
the file will still be returned.</doc>
|
|
<source-position filename="gtlscertificate.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38908">the new certificate, or %NULL if @data is invalid</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="data" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38889">PEM-encoded certificate data</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38890">the length of @data, or -1 if it's 0-terminated.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="list_new_from_file" c:identifier="g_tls_certificate_list_new_from_file" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38817">Creates one or more #GTlsCertificates from the PEM-encoded
|
|
data in @file. If @file cannot be read or parsed, the function will
|
|
return %NULL and set @error. If @file does not contain any
|
|
PEM-encoded certificates, this will return an empty list and not
|
|
set @error.</doc>
|
|
<source-position filename="gtlscertificate.h" line="75"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38828">a
|
|
#GList containing #GTlsCertificate objects. You must free the list
|
|
and its contents when you are done with it.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="TlsCertificate"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38819">file containing PEM-encoded certificates to import</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="verify" invoker="verify" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38913">This verifies @cert and returns a set of #GTlsCertificateFlags
|
|
indicating any problems found with it. This can be used to verify a
|
|
certificate outside the context of making a connection, or to
|
|
check a certificate against a CA that is not part of the system
|
|
CA database.
|
|
|
|
If @identity is not %NULL, @cert's name(s) will be compared against
|
|
it, and %G_TLS_CERTIFICATE_BAD_IDENTITY will be set in the return
|
|
value if it does not match. If @identity is %NULL, that bit will
|
|
never be set in the return value.
|
|
|
|
If @trusted_ca is not %NULL, then @cert (or one of the certificates
|
|
in its chain) must be signed by it, or else
|
|
%G_TLS_CERTIFICATE_UNKNOWN_CA will be set in the return value. If
|
|
@trusted_ca is %NULL, that bit will never be set in the return
|
|
value.
|
|
|
|
(All other #GTlsCertificateFlags values will always be set or unset
|
|
as appropriate.)</doc>
|
|
<source-position filename="gtlscertificate.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38939">the appropriate #GTlsCertificateFlags</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38915">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</instance-parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38916">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="trusted_ca" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38917">the certificate of a trusted authority</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_issuer" c:identifier="g_tls_certificate_get_issuer" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38788">Gets the #GTlsCertificate representing @cert's issuer, if known</doc>
|
|
<source-position filename="gtlscertificate.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38794">The certificate of @cert's issuer,
|
|
or %NULL if @cert is self-signed or signed with an unknown
|
|
certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38790">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_same" c:identifier="g_tls_certificate_is_same" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38801">Check if two #GTlsCertificate objects represent the same certificate.
|
|
The raw DER byte data of the two certificates are checked for equality.
|
|
This has the effect that two certificates may compare equal even if
|
|
their #GTlsCertificate:issuer, #GTlsCertificate:private-key, or
|
|
#GTlsCertificate:private-key-pem properties differ.</doc>
|
|
<source-position filename="gtlscertificate.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38812">whether the same or not</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cert_one" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38803">first certificate to compare</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</instance-parameter>
|
|
<parameter name="cert_two" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38804">second certificate to compare</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="verify" c:identifier="g_tls_certificate_verify" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38913">This verifies @cert and returns a set of #GTlsCertificateFlags
|
|
indicating any problems found with it. This can be used to verify a
|
|
certificate outside the context of making a connection, or to
|
|
check a certificate against a CA that is not part of the system
|
|
CA database.
|
|
|
|
If @identity is not %NULL, @cert's name(s) will be compared against
|
|
it, and %G_TLS_CERTIFICATE_BAD_IDENTITY will be set in the return
|
|
value if it does not match. If @identity is %NULL, that bit will
|
|
never be set in the return value.
|
|
|
|
If @trusted_ca is not %NULL, then @cert (or one of the certificates
|
|
in its chain) must be signed by it, or else
|
|
%G_TLS_CERTIFICATE_UNKNOWN_CA will be set in the return value. If
|
|
@trusted_ca is %NULL, that bit will never be set in the return
|
|
value.
|
|
|
|
(All other #GTlsCertificateFlags values will always be set or unset
|
|
as appropriate.)</doc>
|
|
<source-position filename="gtlscertificate.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38939">the appropriate #GTlsCertificateFlags</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38915">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</instance-parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38916">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="trusted_ca" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38917">the certificate of a trusted authority</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="certificate" version="2.28" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3562">The DER (binary) encoded representation of the certificate.
|
|
This property and the #GTlsCertificate:certificate-pem property
|
|
represent the same data, just in different forms.</doc>
|
|
<array name="GLib.ByteArray">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</property>
|
|
<property name="certificate-pem" version="2.28" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3573">The PEM (ASCII) encoded representation of the certificate.
|
|
This property and the #GTlsCertificate:certificate
|
|
property represent the same data, just in different forms.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="issuer" version="2.28" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3584">A #GTlsCertificate representing the entity that issued this
|
|
certificate. If %NULL, this means that the certificate is either
|
|
self-signed, or else the certificate of the issuer is not
|
|
available.</doc>
|
|
<type name="TlsCertificate"/>
|
|
</property>
|
|
<property name="private-key" version="2.28" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3596">The DER (binary) encoded representation of the certificate's
|
|
private key, in either PKCS#1 format or unencrypted PKCS#8
|
|
format. This property (or the #GTlsCertificate:private-key-pem
|
|
property) can be set when constructing a key (eg, from a file),
|
|
but cannot be read.
|
|
|
|
PKCS#8 format is supported since 2.32; earlier releases only
|
|
support PKCS#1. You can use the `openssl rsa`
|
|
tool to convert PKCS#8 keys to PKCS#1.</doc>
|
|
<array name="GLib.ByteArray">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</property>
|
|
<property name="private-key-pem" version="2.28" readable="0" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3613">The PEM (ASCII) encoded representation of the certificate's
|
|
private key in either PKCS#1 format ("`BEGIN RSA PRIVATE
|
|
KEY`") or unencrypted PKCS#8 format ("`BEGIN
|
|
PRIVATE KEY`"). This property (or the
|
|
#GTlsCertificate:private-key property) can be set when
|
|
constructing a key (eg, from a file), but cannot be read.
|
|
|
|
PKCS#8 format is supported since 2.32; earlier releases only
|
|
support PKCS#1. You can use the `openssl rsa`
|
|
tool to convert PKCS#8 keys to PKCS#1.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="TlsCertificatePrivate" c:type="GTlsCertificatePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="TlsCertificateClass" c:type="GTlsCertificateClass" glib:is-gtype-struct-for="TlsCertificate">
|
|
<source-position filename="gtlscertificate.h" line="57"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="verify">
|
|
<callback name="verify">
|
|
<source-position filename="gtlscertificate.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38939">the appropriate #GTlsCertificateFlags</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38915">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38916">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="trusted_ca" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38917">the certificate of a trusted authority</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<bitfield name="TlsCertificateFlags" version="2.28" glib:type-name="GTlsCertificateFlags" glib:get-type="g_tls_certificate_flags_get_type" c:type="GTlsCertificateFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1558">A set of flags describing TLS certification validation. This can be
|
|
used to set which validation steps to perform (eg, with
|
|
g_tls_client_connection_set_validation_flags()), or to describe why
|
|
a particular certificate was rejected (eg, in
|
|
#GTlsConnection::accept-certificate).</doc>
|
|
<member name="unknown_ca" value="1" c:identifier="G_TLS_CERTIFICATE_UNKNOWN_CA" glib:nick="unknown-ca">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1560">The signing certificate authority is
|
|
not known.</doc>
|
|
</member>
|
|
<member name="bad_identity" value="2" c:identifier="G_TLS_CERTIFICATE_BAD_IDENTITY" glib:nick="bad-identity">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1562">The certificate does not match the
|
|
expected identity of the site that it was retrieved from.</doc>
|
|
</member>
|
|
<member name="not_activated" value="4" c:identifier="G_TLS_CERTIFICATE_NOT_ACTIVATED" glib:nick="not-activated">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1564">The certificate's activation time
|
|
is still in the future</doc>
|
|
</member>
|
|
<member name="expired" value="8" c:identifier="G_TLS_CERTIFICATE_EXPIRED" glib:nick="expired">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1566">The certificate has expired</doc>
|
|
</member>
|
|
<member name="revoked" value="16" c:identifier="G_TLS_CERTIFICATE_REVOKED" glib:nick="revoked">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1567">The certificate has been revoked
|
|
according to the #GTlsConnection's certificate revocation list.</doc>
|
|
</member>
|
|
<member name="insecure" value="32" c:identifier="G_TLS_CERTIFICATE_INSECURE" glib:nick="insecure">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1569">The certificate's algorithm is
|
|
considered insecure.</doc>
|
|
</member>
|
|
<member name="generic_error" value="64" c:identifier="G_TLS_CERTIFICATE_GENERIC_ERROR" glib:nick="generic-error">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1571">Some other error occurred validating
|
|
the certificate</doc>
|
|
</member>
|
|
<member name="validate_all" value="127" c:identifier="G_TLS_CERTIFICATE_VALIDATE_ALL" glib:nick="validate-all">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1573">the combination of all of the above
|
|
flags</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="TlsCertificatePrivate" c:type="GTlsCertificatePrivate" disguised="1">
|
|
<source-position filename="gtlscertificate.h" line="38"/>
|
|
</record>
|
|
<enumeration name="TlsCertificateRequestFlags" version="2.40" glib:type-name="GTlsCertificateRequestFlags" glib:get-type="g_tls_certificate_request_flags_get_type" c:type="GTlsCertificateRequestFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1740">Flags for g_tls_interaction_request_certificate(),
|
|
g_tls_interaction_request_certificate_async(), and
|
|
g_tls_interaction_invoke_request_certificate().</doc>
|
|
<member name="none" value="0" c:identifier="G_TLS_CERTIFICATE_REQUEST_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1742">No flags</doc>
|
|
</member>
|
|
</enumeration>
|
|
<interface name="TlsClientConnection" c:symbol-prefix="tls_client_connection" c:type="GTlsClientConnection" version="2.28" glib:type-name="GTlsClientConnection" glib:get-type="g_tls_client_connection_get_type" glib:type-struct="TlsClientConnectionInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9442">#GTlsClientConnection is the client-side subclass of
|
|
#GTlsConnection, representing a client-side TLS connection.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="52"/>
|
|
<prerequisite name="TlsConnection"/>
|
|
<function name="new" c:identifier="g_tls_client_connection_new" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39018">Creates a new #GTlsClientConnection wrapping @base_io_stream (which
|
|
must have pollable input and output streams) which is assumed to
|
|
communicate with the server identified by @server_identity.
|
|
|
|
See the documentation for #GTlsConnection:base-io-stream for restrictions
|
|
on when application code can run operations on the @base_io_stream after
|
|
this function has returned.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="58"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39032">the new
|
|
#GTlsClientConnection, or %NULL on error</doc>
|
|
<type name="TlsClientConnection" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_io_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39020">the #GIOStream to wrap</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="server_identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39021">the expected identity of the server</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<virtual-method name="copy_session_state" invoker="copy_session_state" version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38944">Copies session state from one connection to another. This is
|
|
not normally needed, but may be used when the same session
|
|
needs to be used between different endpoints as is required
|
|
by some protocols such as FTP over TLS. @source should have
|
|
already completed a handshake, and @conn should not have
|
|
completed a handshake.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38946">a #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38947">a #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="copy_session_state" c:identifier="g_tls_client_connection_copy_session_state" version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38944">Copies session state from one connection to another. This is
|
|
not normally needed, but may be used when the same session
|
|
needs to be used between different endpoints as is required
|
|
by some protocols such as FTP over TLS. @source should have
|
|
already completed a handshake, and @conn should not have
|
|
completed a handshake.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38946">a #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38947">a #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_accepted_cas" c:identifier="g_tls_client_connection_get_accepted_cas" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38960">Gets the list of distinguished names of the Certificate Authorities
|
|
that the server will accept certificates from. This will be set
|
|
during the TLS handshake if the server requests a certificate.
|
|
Otherwise, it will be %NULL.
|
|
|
|
Each item in the list is a #GByteArray which contains the complete
|
|
subject DN of the certificate authority.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38972">the list of
|
|
CA DNs. You should unref each element with g_byte_array_unref() and then
|
|
the free the list with g_list_free().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<array name="GLib.ByteArray">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38962">the #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_server_identity" c:identifier="g_tls_client_connection_get_server_identity" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38979">Gets @conn's expected server identity</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38985">a #GSocketConnectable describing the
|
|
expected server identity, or %NULL if the expected identity is not
|
|
known.</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38981">the #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_use_ssl3" c:identifier="g_tls_client_connection_get_use_ssl3" version="2.28" deprecated="1" deprecated-version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38992">Gets whether @conn will force the lowest-supported TLS protocol
|
|
version rather than attempt to negotiate the highest mutually-
|
|
supported version of TLS; see g_tls_client_connection_set_use_ssl3().</doc>
|
|
<doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this function does not
|
|
actually indicate whether it is enabled.</doc-deprecated>
|
|
<source-position filename="gtlsclientconnection.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39000">whether @conn will use the lowest-supported TLS protocol version</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38994">the #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_validation_flags" c:identifier="g_tls_client_connection_get_validation_flags" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39007">Gets @conn's validation flags</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39013">the validation flags</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39009">the #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_server_identity" c:identifier="g_tls_client_connection_set_server_identity" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39038">Sets @conn's expected server identity, which is used both to tell
|
|
servers on virtual hosts which certificate to present, and also
|
|
to let @conn know what name to look for in the certificate when
|
|
performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39040">the #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="identity" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39041">a #GSocketConnectable describing the expected server identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_use_ssl3" c:identifier="g_tls_client_connection_set_use_ssl3" version="2.28" deprecated="1" deprecated-version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39052">Since 2.42.1, if @use_ssl3 is %TRUE, this forces @conn to use the
|
|
lowest-supported TLS protocol version rather than trying to properly
|
|
negotiate the highest mutually-supported protocol version with the
|
|
peer. Be aware that SSL 3.0 is generally disabled by the
|
|
#GTlsBackend, so the lowest-supported protocol version is probably
|
|
not SSL 3.0.
|
|
|
|
Since 2.58, this may additionally cause an RFC 7507 fallback SCSV to
|
|
be sent to the server, causing modern TLS servers to immediately
|
|
terminate the connection. You should generally only use this function
|
|
if you need to connect to broken servers that exhibit TLS protocol
|
|
version intolerance, and when an initial attempt to connect to a
|
|
server normally has already failed.</doc>
|
|
<doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this function does not
|
|
generally enable or disable it, despite its name.</doc-deprecated>
|
|
<source-position filename="gtlsclientconnection.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39054">the #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="use_ssl3" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39055">whether to use the lowest-supported protocol version</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_validation_flags" c:identifier="g_tls_client_connection_set_validation_flags" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39077">Sets @conn's validation flags, to override the default set of
|
|
checks performed when validating a server certificate. By default,
|
|
%G_TLS_CERTIFICATE_VALIDATE_ALL is used.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39079">the #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39080">the #GTlsCertificateFlags to use</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="accepted-cas" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3641">A list of the distinguished names of the Certificate Authorities
|
|
that the server will accept client certificates signed by. If the
|
|
server requests a client certificate during the handshake, then
|
|
this property will be set after the handshake completes.
|
|
|
|
Each item in the list is a #GByteArray which contains the complete
|
|
subject DN of the certificate authority.</doc>
|
|
<type name="GLib.List" c:type="gpointer">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</property>
|
|
<property name="server-identity" version="2.28" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3656">A #GSocketConnectable describing the identity of the server that
|
|
is expected on the other end of the connection.
|
|
|
|
If the %G_TLS_CERTIFICATE_BAD_IDENTITY flag is set in
|
|
#GTlsClientConnection:validation-flags, this object will be used
|
|
to determine the expected identify of the remote end of the
|
|
connection; if #GTlsClientConnection:server-identity is not set,
|
|
or does not match the identity presented by the server, then the
|
|
%G_TLS_CERTIFICATE_BAD_IDENTITY validation will fail.
|
|
|
|
In addition to its use in verifying the server certificate,
|
|
this is also used to give a hint to the server about what
|
|
certificate we expect, which is useful for servers that serve
|
|
virtual hosts.</doc>
|
|
<type name="SocketConnectable"/>
|
|
</property>
|
|
<property name="use-ssl3" version="2.28" deprecated="1" deprecated-version="2.56" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3678">If %TRUE, forces the connection to use a fallback version of TLS
|
|
or SSL, rather than trying to negotiate the best version of TLS
|
|
to use. See g_tls_client_connection_set_use_ssl3().</doc>
|
|
<doc-deprecated xml:space="preserve">SSL 3.0 is insecure, and this property does not
|
|
generally enable or disable it, despite its name.</doc-deprecated>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="validation-flags" version="2.28" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3691">What steps to perform when validating a certificate received from
|
|
a server. Server certificates that fail to validate in all of the
|
|
ways indicated here will be rejected unless the application
|
|
overrides the default via #GTlsConnection::accept-certificate.</doc>
|
|
<type name="TlsCertificateFlags"/>
|
|
</property>
|
|
</interface>
|
|
<record name="TlsClientConnectionInterface" c:type="GTlsClientConnectionInterface" glib:is-gtype-struct-for="TlsClientConnection" version="2.26">
|
|
<doc xml:space="preserve" filename="gtlsclientconnection.h" line="37">vtable for a #GTlsClientConnection implementation.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="52"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gtlsclientconnection.h" line="39">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="copy_session_state">
|
|
<callback name="copy_session_state">
|
|
<source-position filename="gtlsclientconnection.h" line="50"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38946">a #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38947">a #GTlsClientConnection</doc>
|
|
<type name="TlsClientConnection" c:type="GTlsClientConnection*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="TlsConnection" c:symbol-prefix="tls_connection" c:type="GTlsConnection" version="2.28" parent="IOStream" abstract="1" glib:type-name="GTlsConnection" glib:get-type="g_tls_connection_get_type" glib:type-struct="TlsConnectionClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9452">#GTlsConnection is the base TLS connection class type, which wraps
|
|
a #GIOStream and provides TLS encryption on top of it. Its
|
|
subclasses, #GTlsClientConnection and #GTlsServerConnection,
|
|
implement client-side and server-side TLS, respectively.
|
|
|
|
For DTLS (Datagram TLS) support, see #GDtlsConnection.</doc>
|
|
<source-position filename="gtlsconnection.h" line="72"/>
|
|
<virtual-method name="accept_certificate">
|
|
<source-position filename="gtlsconnection.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handshake" invoker="handshake" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39226">Attempts a TLS handshake on @conn.
|
|
|
|
On the client side, it is never necessary to call this method;
|
|
although the connection needs to perform a handshake after
|
|
connecting (or after sending a "STARTTLS"-type command) and may
|
|
need to rehandshake later if the server requests it,
|
|
#GTlsConnection will handle this for you automatically when you try
|
|
to send or receive data on the connection. However, you can call
|
|
g_tls_connection_handshake() manually if you want to know for sure
|
|
whether the initial handshake succeeded or failed (as opposed to
|
|
just immediately trying to write to @conn's output stream, in which
|
|
case if it fails, it may not be possible to tell if it failed
|
|
before or after completing the handshake).
|
|
|
|
Likewise, on the server side, although a handshake is necessary at
|
|
the beginning of the communication, you do not need to call this
|
|
function explicitly unless you want clearer error reporting.
|
|
|
|
If TLS 1.2 or older is in use, you may call
|
|
g_tls_connection_handshake() after the initial handshake to
|
|
rehandshake; however, this usage is deprecated because rehandshaking
|
|
is no longer part of the TLS protocol in TLS 1.3. Accordingly, the
|
|
behavior of calling this function after the initial handshake is now
|
|
undefined, except it is guaranteed to be reasonable and
|
|
nondestructive so as to preserve compatibility with code written for
|
|
older versions of GLib.
|
|
|
|
#GTlsConnection::accept_certificate may be emitted during the
|
|
handshake.</doc>
|
|
<source-position filename="gtlsconnection.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39262">success or failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39228">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39229">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handshake_async" invoker="handshake_async" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39267">Asynchronously performs a TLS handshake on @conn. See
|
|
g_tls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gtlsconnection.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39269">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39270">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39271">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39272">callback to call when the handshake is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39273">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="handshake_finish" invoker="handshake_finish" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39282">Finish an asynchronous TLS handshake operation. See
|
|
g_tls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gtlsconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39291">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39284">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39285">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="emit_accept_certificate" c:identifier="g_tls_connection_emit_accept_certificate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39090">Used by #GTlsConnection implementations to emit the
|
|
#GTlsConnection::accept-certificate signal.</doc>
|
|
<source-position filename="gtlsconnection.h" line="157"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39099">%TRUE if one of the signal handlers has returned
|
|
%TRUE to accept @peer_cert</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39092">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39093">the peer's #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39094">the problems with @peer_cert</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_certificate" c:identifier="g_tls_connection_get_certificate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39105">Gets @conn's certificate, as set by
|
|
g_tls_connection_set_certificate().</doc>
|
|
<source-position filename="gtlsconnection.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39112">@conn's certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39107">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_database" c:identifier="g_tls_connection_get_database" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39117">Gets the certificate database that @conn uses to verify
|
|
peer certificates. See g_tls_connection_set_database().</doc>
|
|
<source-position filename="gtlsconnection.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39124">the certificate database that @conn uses or %NULL</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39119">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_interaction" c:identifier="g_tls_connection_get_interaction" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39129">Get the object that will be used to interact with the user. It will be used
|
|
for things like prompting the user for passwords. If %NULL is returned, then
|
|
no user interaction will occur for this connection.</doc>
|
|
<source-position filename="gtlsconnection.h" line="99"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39137">The interaction object.</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39131">a connection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_negotiated_protocol" c:identifier="g_tls_connection_get_negotiated_protocol" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39142">Gets the name of the application-layer protocol negotiated during
|
|
the handshake.
|
|
|
|
If the peer did not use the ALPN extension, or did not advertise a
|
|
protocol that matched one of @conn's protocols, or the TLS backend
|
|
does not support ALPN, then this will be %NULL. See
|
|
g_tls_connection_set_advertised_protocols().</doc>
|
|
<source-position filename="gtlsconnection.h" line="125"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39154">the negotiated protocol, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39144">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_peer_certificate" c:identifier="g_tls_connection_get_peer_certificate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39159">Gets @conn's peer's certificate after the handshake has completed.
|
|
(It is not set during the emission of
|
|
#GTlsConnection::accept-certificate.)</doc>
|
|
<source-position filename="gtlsconnection.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39167">@conn's peer's certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39161">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_peer_certificate_errors" c:identifier="g_tls_connection_get_peer_certificate_errors" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39172">Gets the errors associated with validating @conn's peer's
|
|
certificate, after the handshake has completed. (It is not set
|
|
during the emission of #GTlsConnection::accept-certificate.)</doc>
|
|
<source-position filename="gtlsconnection.h" line="104"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39180">@conn's peer's certificate errors</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39174">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_rehandshake_mode" c:identifier="g_tls_connection_get_rehandshake_mode" version="2.28" deprecated="1" deprecated-version="2.60.">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39185">Gets @conn rehandshaking mode. See
|
|
g_tls_connection_set_rehandshake_mode() for details.</doc>
|
|
<doc-deprecated xml:space="preserve">Changing the rehandshake mode is no longer
|
|
required for compatibility. Also, rehandshaking has been removed
|
|
from the TLS protocol in TLS 1.3.</doc-deprecated>
|
|
<source-position filename="gtlsconnection.h" line="117"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39192">@conn's rehandshaking mode</doc>
|
|
<type name="TlsRehandshakeMode" c:type="GTlsRehandshakeMode"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39187">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_require_close_notify" c:identifier="g_tls_connection_get_require_close_notify" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39200">Tests whether or not @conn expects a proper TLS close notification
|
|
when the connection is closed. See
|
|
g_tls_connection_set_require_close_notify() for details.</doc>
|
|
<source-position filename="gtlsconnection.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39208">%TRUE if @conn requires a proper TLS close
|
|
notification.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39202">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_use_system_certdb" c:identifier="g_tls_connection_get_use_system_certdb" deprecated="1" deprecated-version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39214">Gets whether @conn uses the system certificate database to verify
|
|
peer certificates. See g_tls_connection_set_use_system_certdb().</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_tls_connection_get_database() instead</doc-deprecated>
|
|
<source-position filename="gtlsconnection.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39221">whether @conn uses the system certificate database</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39216">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="handshake" c:identifier="g_tls_connection_handshake" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39226">Attempts a TLS handshake on @conn.
|
|
|
|
On the client side, it is never necessary to call this method;
|
|
although the connection needs to perform a handshake after
|
|
connecting (or after sending a "STARTTLS"-type command) and may
|
|
need to rehandshake later if the server requests it,
|
|
#GTlsConnection will handle this for you automatically when you try
|
|
to send or receive data on the connection. However, you can call
|
|
g_tls_connection_handshake() manually if you want to know for sure
|
|
whether the initial handshake succeeded or failed (as opposed to
|
|
just immediately trying to write to @conn's output stream, in which
|
|
case if it fails, it may not be possible to tell if it failed
|
|
before or after completing the handshake).
|
|
|
|
Likewise, on the server side, although a handshake is necessary at
|
|
the beginning of the communication, you do not need to call this
|
|
function explicitly unless you want clearer error reporting.
|
|
|
|
If TLS 1.2 or older is in use, you may call
|
|
g_tls_connection_handshake() after the initial handshake to
|
|
rehandshake; however, this usage is deprecated because rehandshaking
|
|
is no longer part of the TLS protocol in TLS 1.3. Accordingly, the
|
|
behavior of calling this function after the initial handshake is now
|
|
undefined, except it is guaranteed to be reasonable and
|
|
nondestructive so as to preserve compatibility with code written for
|
|
older versions of GLib.
|
|
|
|
#GTlsConnection::accept_certificate may be emitted during the
|
|
handshake.</doc>
|
|
<source-position filename="gtlsconnection.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39262">success or failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39228">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39229">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="handshake_async" c:identifier="g_tls_connection_handshake_async" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39267">Asynchronously performs a TLS handshake on @conn. See
|
|
g_tls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gtlsconnection.h" line="133"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39269">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39270">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39271">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39272">callback to call when the handshake is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39273">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="handshake_finish" c:identifier="g_tls_connection_handshake_finish" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39282">Finish an asynchronous TLS handshake operation. See
|
|
g_tls_connection_handshake() for more information.</doc>
|
|
<source-position filename="gtlsconnection.h" line="139"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39291">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39284">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39285">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_advertised_protocols" c:identifier="g_tls_connection_set_advertised_protocols" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39297">Sets the list of application-layer protocols to advertise that the
|
|
caller is willing to speak on this connection. The
|
|
Application-Layer Protocol Negotiation (ALPN) extension will be
|
|
used to negotiate a compatible protocol with the peer; use
|
|
g_tls_connection_get_negotiated_protocol() to find the negotiated
|
|
protocol after the handshake. Specifying %NULL for the the value
|
|
of @protocols will disable ALPN negotiation.
|
|
|
|
See [IANA TLS ALPN Protocol IDs](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids)
|
|
for a list of registered protocol IDs.</doc>
|
|
<source-position filename="gtlsconnection.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39299">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="protocols" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39300">a %NULL-terminated
|
|
array of ALPN protocol names (eg, "http/1.1", "h2"), or %NULL</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_certificate" c:identifier="g_tls_connection_set_certificate" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39318">This sets the certificate that @conn will present to its peer
|
|
during the TLS handshake. For a #GTlsServerConnection, it is
|
|
mandatory to set this, and that will normally be done at construct
|
|
time.
|
|
|
|
For a #GTlsClientConnection, this is optional. If a handshake fails
|
|
with %G_TLS_ERROR_CERTIFICATE_REQUIRED, that means that the server
|
|
requires a certificate, and if you try connecting again, you should
|
|
call this method first. You can call
|
|
g_tls_client_connection_get_accepted_cas() on the failed connection
|
|
to get a list of Certificate Authorities that the server will
|
|
accept certificates from.
|
|
|
|
(It is also possible that a server will allow the connection with
|
|
or without a certificate; in that case, if you don't provide a
|
|
certificate, you can tell that the server requested one by the fact
|
|
that g_tls_client_connection_get_accepted_cas() will return
|
|
non-%NULL.)</doc>
|
|
<source-position filename="gtlsconnection.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39320">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39321">the certificate to use for @conn</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_database" c:identifier="g_tls_connection_set_database" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39346">Sets the certificate database that is used to verify peer certificates.
|
|
This is set to the default database by default. See
|
|
g_tls_backend_get_default_database(). If set to %NULL, then
|
|
peer certificate validation will always set the
|
|
%G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
|
|
#GTlsConnection::accept-certificate will always be emitted on
|
|
client-side connections, unless that bit is not set in
|
|
#GTlsClientConnection:validation-flags).</doc>
|
|
<source-position filename="gtlsconnection.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39348">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="database" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39349">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_interaction" c:identifier="g_tls_connection_set_interaction" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39364">Set the object that will be used to interact with the user. It will be used
|
|
for things like prompting the user for passwords.
|
|
|
|
The @interaction argument will normally be a derived subclass of
|
|
#GTlsInteraction. %NULL can also be provided if no user interaction
|
|
should occur for this connection.</doc>
|
|
<source-position filename="gtlsconnection.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39366">a connection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39367">an interaction object, or %NULL</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_rehandshake_mode" c:identifier="g_tls_connection_set_rehandshake_mode" version="2.28" deprecated="1" deprecated-version="2.60.">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39380">Sets how @conn behaves with respect to rehandshaking requests, when
|
|
TLS 1.2 or older is in use.
|
|
|
|
%G_TLS_REHANDSHAKE_NEVER means that it will never agree to
|
|
rehandshake after the initial handshake is complete. (For a client,
|
|
this means it will refuse rehandshake requests from the server, and
|
|
for a server, this means it will close the connection with an error
|
|
if the client attempts to rehandshake.)
|
|
|
|
%G_TLS_REHANDSHAKE_SAFELY means that the connection will allow a
|
|
rehandshake only if the other end of the connection supports the
|
|
TLS `renegotiation_info` extension. This is the default behavior,
|
|
but means that rehandshaking will not work against older
|
|
implementations that do not support that extension.
|
|
|
|
%G_TLS_REHANDSHAKE_UNSAFELY means that the connection will allow
|
|
rehandshaking even without the `renegotiation_info` extension. On
|
|
the server side in particular, this is not recommended, since it
|
|
leaves the server open to certain attacks. However, this mode is
|
|
necessary if you need to allow renegotiation with older client
|
|
software.</doc>
|
|
<doc-deprecated xml:space="preserve">Changing the rehandshake mode is no longer
|
|
required for compatibility. Also, rehandshaking has been removed
|
|
from the TLS protocol in TLS 1.3.</doc-deprecated>
|
|
<source-position filename="gtlsconnection.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39382">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="mode" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39383">the rehandshaking mode</doc>
|
|
<type name="TlsRehandshakeMode" c:type="GTlsRehandshakeMode"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_require_close_notify" c:identifier="g_tls_connection_set_require_close_notify" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39414">Sets whether or not @conn expects a proper TLS close notification
|
|
before the connection is closed. If this is %TRUE (the default),
|
|
then @conn will expect to receive a TLS close notification from its
|
|
peer before the connection is closed, and will return a
|
|
%G_TLS_ERROR_EOF error if the connection is closed without proper
|
|
notification (since this may indicate a network error, or
|
|
man-in-the-middle attack).
|
|
|
|
In some protocols, the application will know whether or not the
|
|
connection was closed cleanly based on application-level data
|
|
(because the application-level data includes a length field, or is
|
|
somehow self-delimiting); in this case, the close notify is
|
|
redundant and sometimes omitted. (TLS 1.1 explicitly allows this;
|
|
in TLS 1.0 it is technically an error, but often done anyway.) You
|
|
can use g_tls_connection_set_require_close_notify() to tell @conn
|
|
to allow an "unannounced" connection close, in which case the close
|
|
will show up as a 0-length read, as in a non-TLS
|
|
#GSocketConnection, and it is up to the application to check that
|
|
the data has been fully received.
|
|
|
|
Note that this only affects the behavior when the peer closes the
|
|
connection; when the application calls g_io_stream_close() itself
|
|
on @conn, this will send a close notification regardless of the
|
|
setting of this property. If you explicitly want to do an unclean
|
|
close, you can close @conn's #GTlsConnection:base-io-stream rather
|
|
than closing @conn itself, but note that this may only be done when no other
|
|
operations are pending on @conn or the base I/O stream.</doc>
|
|
<source-position filename="gtlsconnection.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39416">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="require_close_notify" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39417">whether or not to require close notification</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_use_system_certdb" c:identifier="g_tls_connection_set_use_system_certdb" deprecated="1" deprecated-version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39451">Sets whether @conn uses the system certificate database to verify
|
|
peer certificates. This is %TRUE by default. If set to %FALSE, then
|
|
peer certificate validation will always set the
|
|
%G_TLS_CERTIFICATE_UNKNOWN_CA error (meaning
|
|
#GTlsConnection::accept-certificate will always be emitted on
|
|
client-side connections, unless that bit is not set in
|
|
#GTlsClientConnection:validation-flags).</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_tls_connection_set_database() instead</doc-deprecated>
|
|
<source-position filename="gtlsconnection.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39453">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="use_system_certdb" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39454">whether to use the system certificate database</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="advertised-protocols" version="2.60" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3761">The list of application-layer protocols that the connection
|
|
advertises that it is willing to speak. See
|
|
g_tls_connection_set_advertised_protocols().</doc>
|
|
<array>
|
|
<type name="utf8"/>
|
|
</array>
|
|
</property>
|
|
<property name="base-io-stream" version="2.28" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3772">The #GIOStream that the connection wraps. The connection holds a reference
|
|
to this stream, and may run operations on the stream from other threads
|
|
throughout its lifetime. Consequently, after the #GIOStream has been
|
|
constructed, application code may only run its own operations on this
|
|
stream when no #GIOStream operations are running.</doc>
|
|
<type name="IOStream"/>
|
|
</property>
|
|
<property name="certificate" version="2.28" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3785">The connection's certificate; see
|
|
g_tls_connection_set_certificate().</doc>
|
|
<type name="TlsCertificate"/>
|
|
</property>
|
|
<property name="database" version="2.30" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3795">The certificate database to use when verifying this TLS connection.
|
|
If no certificate database is set, then the default database will be
|
|
used. See g_tls_backend_get_default_database().</doc>
|
|
<type name="TlsDatabase"/>
|
|
</property>
|
|
<property name="interaction" version="2.30" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3806">A #GTlsInteraction object to be used when the connection or certificate
|
|
database need to interact with the user. This will be used to prompt the
|
|
user for passwords where necessary.</doc>
|
|
<type name="TlsInteraction"/>
|
|
</property>
|
|
<property name="negotiated-protocol" version="2.60" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3817">The application-layer protocol negotiated during the TLS
|
|
handshake. See g_tls_connection_get_negotiated_protocol().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="peer-certificate" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3827">The connection's peer's certificate, after the TLS handshake has
|
|
completed and the certificate has been accepted. Note in
|
|
particular that this is not yet set during the emission of
|
|
#GTlsConnection::accept-certificate.
|
|
|
|
(You can watch for a #GObject::notify signal on this property to
|
|
detect when a handshake has occurred.)</doc>
|
|
<type name="TlsCertificate"/>
|
|
</property>
|
|
<property name="peer-certificate-errors" version="2.28" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3842">The errors noticed-and-ignored while verifying
|
|
#GTlsConnection:peer-certificate. Normally this should be 0, but
|
|
it may not be if #GTlsClientConnection:validation-flags is not
|
|
%G_TLS_CERTIFICATE_VALIDATE_ALL, or if
|
|
#GTlsConnection::accept-certificate overrode the default
|
|
behavior.</doc>
|
|
<type name="TlsCertificateFlags"/>
|
|
</property>
|
|
<property name="rehandshake-mode" version="2.28" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3856">The rehandshaking mode. See
|
|
g_tls_connection_set_rehandshake_mode().</doc>
|
|
<type name="TlsRehandshakeMode"/>
|
|
</property>
|
|
<property name="require-close-notify" version="2.28" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3866">Whether or not proper TLS close notification is required.
|
|
See g_tls_connection_set_require_close_notify().</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="use-system-certdb" deprecated="1" deprecated-version="2.30" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3876">Whether or not the system certificate database will be used to
|
|
verify peer certificates. See
|
|
g_tls_connection_set_use_system_certdb().</doc>
|
|
<doc-deprecated xml:space="preserve">Use GTlsConnection:database instead</doc-deprecated>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="IOStream" c:type="GIOStream"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="TlsConnectionPrivate" c:type="GTlsConnectionPrivate*"/>
|
|
</field>
|
|
<glib:signal name="accept-certificate" when="last" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3713">Emitted during the TLS handshake after the peer certificate has
|
|
been received. You can examine @peer_cert's certification path by
|
|
calling g_tls_certificate_get_issuer() on it.
|
|
|
|
For a client-side connection, @peer_cert is the server's
|
|
certificate, and the signal will only be emitted if the
|
|
certificate was not acceptable according to @conn's
|
|
#GTlsClientConnection:validation_flags. If you would like the
|
|
certificate to be accepted despite @errors, return %TRUE from the
|
|
signal handler. Otherwise, if no handler accepts the certificate,
|
|
the handshake will fail with %G_TLS_ERROR_BAD_CERTIFICATE.
|
|
|
|
For a server-side connection, @peer_cert is the certificate
|
|
presented by the client, if this was requested via the server's
|
|
#GTlsServerConnection:authentication_mode. On the server side,
|
|
the signal is always emitted when the client presents a
|
|
certificate, and the certificate will only be accepted if a
|
|
handler returns %TRUE.
|
|
|
|
Note that if this signal is emitted as part of asynchronous I/O
|
|
in the main thread, then you should not attempt to interact with
|
|
the user before returning from the signal handler. If you want to
|
|
let the user decide whether or not to accept the certificate, you
|
|
would have to return %FALSE from the signal handler on the first
|
|
attempt, and then after the connection attempt returns a
|
|
%G_TLS_ERROR_BAD_CERTIFICATE, you can interact with the user, and
|
|
if the user decides to accept the certificate, remember that fact,
|
|
create a new connection, and return %TRUE from the signal handler
|
|
the next time.
|
|
|
|
If you are doing I/O in another thread, you do not
|
|
need to worry about this, and can simply block in the signal
|
|
handler until the UI thread returns an answer.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3753">%TRUE to accept @peer_cert (which will also
|
|
immediately end the signal emission). %FALSE to allow the signal
|
|
emission to continue, which will cause the handshake to fail if
|
|
no one else overrides it.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3716">the peer's #GTlsCertificate</doc>
|
|
<type name="TlsCertificate"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3717">the problems with @peer_cert.</doc>
|
|
<type name="TlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="TlsConnectionClass" c:type="GTlsConnectionClass" glib:is-gtype-struct-for="TlsConnection">
|
|
<source-position filename="gtlsconnection.h" line="72"/>
|
|
<field name="parent_class">
|
|
<type name="IOStreamClass" c:type="GIOStreamClass"/>
|
|
</field>
|
|
<field name="accept_certificate">
|
|
<callback name="accept_certificate">
|
|
<source-position filename="gtlsconnection.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="peer_cert" transfer-ownership="none">
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="errors" transfer-ownership="none">
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handshake">
|
|
<callback name="handshake" throws="1">
|
|
<source-position filename="gtlsconnection.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39262">success or failure</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39228">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39229">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handshake_async">
|
|
<callback name="handshake_async">
|
|
<source-position filename="gtlsconnection.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39269">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39270">the [I/O priority][io-priority] of the request</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39271">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39272">callback to call when the handshake is complete</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39273">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="handshake_finish">
|
|
<callback name="handshake_finish" throws="1">
|
|
<source-position filename="gtlsconnection.h" line="65"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39291">%TRUE on success, %FALSE on failure, in which
|
|
case @error will be set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="conn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39284">a #GTlsConnection</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39285">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="TlsConnectionPrivate" c:type="GTlsConnectionPrivate" disguised="1">
|
|
<source-position filename="gtlsconnection.h" line="38"/>
|
|
</record>
|
|
<class name="TlsDatabase" c:symbol-prefix="tls_database" c:type="GTlsDatabase" version="2.30" parent="GObject.Object" abstract="1" glib:type-name="GTlsDatabase" glib:get-type="g_tls_database_get_type" glib:type-struct="TlsDatabaseClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9468">#GTlsDatabase is used to look up certificates and other information
|
|
from a certificate or key store. It is an abstract base class which
|
|
TLS library specific subtypes override.
|
|
|
|
A #GTlsDatabase may be accessed from multiple threads by the TLS backend.
|
|
All implementations are required to be fully thread-safe.
|
|
|
|
Most common client applications will not directly interact with
|
|
#GTlsDatabase. It is used internally by #GTlsConnection.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="144"/>
|
|
<virtual-method name="create_certificate_handle" invoker="create_certificate_handle" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39468">Create a handle string for the certificate. The database will only be able
|
|
to create a handle for certificates that originate from the database. In
|
|
cases where the database cannot create a handle for a certificate, %NULL
|
|
will be returned.
|
|
|
|
This handle should be stable across various instances of the application,
|
|
and between applications. If a certificate is modified in the database,
|
|
then it is not guaranteed that this handle will continue to point to it.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="81"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39482">a newly allocated string containing the
|
|
handle.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39470">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39471">certificate for which to create a handle.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificate_for_handle" invoker="lookup_certificate_for_handle" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39488">Look up a certificate by its handle.
|
|
|
|
The handle should have been created by calling
|
|
g_tls_database_create_certificate_handle() on a #GTlsDatabase object of
|
|
the same TLS backend. The handle is designed to remain valid across
|
|
instantiations of the database.
|
|
|
|
If the handle is no longer valid, or does not point to a certificate in
|
|
this database, then %NULL will be returned.
|
|
|
|
This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform
|
|
the lookup operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="84"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39510">a newly allocated
|
|
#GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39490">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="handle" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39491">a certificate handle</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39492">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39493">Flags which affect the lookup.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39494">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificate_for_handle_async" invoker="lookup_certificate_for_handle_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39516">Asynchronously look up a certificate by its handle in the database. See
|
|
g_tls_database_lookup_certificate_for_handle() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39518">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="handle" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39519">a certificate handle</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39520">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39521">Flags which affect the lookup.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39522">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39523">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39524">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificate_for_handle_finish" invoker="lookup_certificate_for_handle_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39533">Finish an asynchronous lookup of a certificate by its handle. See
|
|
g_tls_database_lookup_certificate_for_handle() for more information.
|
|
|
|
If the handle is no longer valid, or does not point to a certificate in
|
|
this database, then %NULL will be returned.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39545">a newly allocated #GTlsCertificate object.
|
|
Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39535">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39536">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificate_issuer" invoker="lookup_certificate_issuer" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39551">Look up the issuer of @certificate in the database.
|
|
|
|
The #GTlsCertificate:issuer property
|
|
of @certificate is not modified, and the two certificates are not hooked
|
|
into a chain.
|
|
|
|
This function can block, use g_tls_database_lookup_certificate_issuer_async() to perform
|
|
the lookup operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="103"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39569">a newly allocated issuer #GTlsCertificate,
|
|
or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39553">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39554">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39555">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39556">flags which affect the lookup operation</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39557">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificate_issuer_async" invoker="lookup_certificate_issuer_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39575">Asynchronously look up the issuer of @certificate in the database. See
|
|
g_tls_database_lookup_certificate_issuer() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39577">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39578">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39579">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39580">flags which affect the lookup operation</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39581">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39582">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39583">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificate_issuer_finish" invoker="lookup_certificate_issuer_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39592">Finish an asynchronous lookup issuer operation. See
|
|
g_tls_database_lookup_certificate_issuer() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="118"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39601">a newly allocated issuer #GTlsCertificate,
|
|
or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39594">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39595">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificates_issued_by" invoker="lookup_certificates_issued_by" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39607">Look up certificates issued by this issuer in the database.
|
|
|
|
This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform
|
|
the lookup operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="122"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39621">a newly allocated list of #GTlsCertificate
|
|
objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="TlsCertificate"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39609">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="issuer_raw_dn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39610">a #GByteArray which holds the DER encoded issuer DN.</doc>
|
|
<array name="GLib.ByteArray" c:type="GByteArray*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39611">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39612">Flags which affect the lookup operation.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39613">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificates_issued_by_async" invoker="lookup_certificates_issued_by_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39627">Asynchronously look up certificates issued by this issuer in the database. See
|
|
g_tls_database_lookup_certificates_issued_by() for more information.
|
|
|
|
The database may choose to hold a reference to the issuer byte array for the duration
|
|
of of this asynchronous operation. The byte array should not be modified during
|
|
this time.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39629">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="issuer_raw_dn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39630">a #GByteArray which holds the DER encoded issuer DN.</doc>
|
|
<array name="GLib.ByteArray" c:type="GByteArray*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39631">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39632">Flags which affect the lookup operation.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39633">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39634">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39635">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="lookup_certificates_issued_by_finish" invoker="lookup_certificates_issued_by_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39648">Finish an asynchronous lookup of certificates. See
|
|
g_tls_database_lookup_certificates_issued_by() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="137"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39657">a newly allocated list of #GTlsCertificate
|
|
objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="TlsCertificate"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39650">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39651">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="verify_chain" invoker="verify_chain" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39663">Determines the validity of a certificate chain after looking up and
|
|
adding any missing certificates to the chain.
|
|
|
|
@chain is a chain of #GTlsCertificate objects each pointing to the next
|
|
certificate in the chain by its #GTlsCertificate:issuer property. The chain may initially
|
|
consist of one or more certificates. After the verification process is
|
|
complete, @chain may be modified by adding missing certificates, or removing
|
|
extra certificates. If a certificate anchor was found, then it is added to
|
|
the @chain.
|
|
|
|
@purpose describes the purpose (or usage) for which the certificate
|
|
is being used. Typically @purpose will be set to #G_TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER
|
|
which means that the certificate is being used to authenticate a server
|
|
(and we are acting as the client).
|
|
|
|
The @identity is used to check for pinned certificates (trust exceptions)
|
|
in the database. These will override the normal verification process on a
|
|
host by host basis.
|
|
|
|
Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be
|
|
used.
|
|
|
|
If @chain is found to be valid, then the return value will be 0. If
|
|
@chain is found to be invalid, then the return value will indicate
|
|
the problems found. If the function is unable to determine whether
|
|
@chain is valid or not (eg, because @cancellable is triggered
|
|
before it completes) then the return value will be
|
|
%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
|
|
accordingly. @error is not set when @chain is successfully analyzed
|
|
but found to be invalid.
|
|
|
|
This function can block, use g_tls_database_verify_chain_async() to perform
|
|
the verification operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39708">the appropriate #GTlsCertificateFlags which represents the
|
|
result of verification.</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39665">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="chain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39666">a #GTlsCertificate chain</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="purpose" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39667">the purpose that this certificate chain will be used for.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39668">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39669">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39670">additional verify flags</doc>
|
|
<type name="TlsDatabaseVerifyFlags" c:type="GTlsDatabaseVerifyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39671">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="verify_chain_async" invoker="verify_chain_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39714">Asynchronously determines the validity of a certificate chain after
|
|
looking up and adding any missing certificates to the chain. See
|
|
g_tls_database_verify_chain() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39716">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="chain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39717">a #GTlsCertificate chain</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="purpose" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39718">the purpose that this certificate chain will be used for.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39719">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39720">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39721">additional verify flags</doc>
|
|
<type name="TlsDatabaseVerifyFlags" c:type="GTlsDatabaseVerifyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39722">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39723">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39724">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="verify_chain_finish" invoker="verify_chain_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39734">Finish an asynchronous verify chain operation. See
|
|
g_tls_database_verify_chain() for more information.
|
|
|
|
If @chain is found to be valid, then the return value will be 0. If
|
|
@chain is found to be invalid, then the return value will indicate
|
|
the problems found. If the function is unable to determine whether
|
|
@chain is valid or not (eg, because @cancellable is triggered
|
|
before it completes) then the return value will be
|
|
%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
|
|
accordingly. @error is not set when @chain is successfully analyzed
|
|
but found to be invalid.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39752">the appropriate #GTlsCertificateFlags which represents the
|
|
result of verification.</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39736">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39737">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="create_certificate_handle" c:identifier="g_tls_database_create_certificate_handle" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39468">Create a handle string for the certificate. The database will only be able
|
|
to create a handle for certificates that originate from the database. In
|
|
cases where the database cannot create a handle for a certificate, %NULL
|
|
will be returned.
|
|
|
|
This handle should be stable across various instances of the application,
|
|
and between applications. If a certificate is modified in the database,
|
|
then it is not guaranteed that this handle will continue to point to it.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="176"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39482">a newly allocated string containing the
|
|
handle.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39470">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39471">certificate for which to create a handle.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificate_for_handle" c:identifier="g_tls_database_lookup_certificate_for_handle" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39488">Look up a certificate by its handle.
|
|
|
|
The handle should have been created by calling
|
|
g_tls_database_create_certificate_handle() on a #GTlsDatabase object of
|
|
the same TLS backend. The handle is designed to remain valid across
|
|
instantiations of the database.
|
|
|
|
If the handle is no longer valid, or does not point to a certificate in
|
|
this database, then %NULL will be returned.
|
|
|
|
This function can block, use g_tls_database_lookup_certificate_for_handle_async() to perform
|
|
the lookup operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="180"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39510">a newly allocated
|
|
#GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39490">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="handle" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39491">a certificate handle</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39492">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39493">Flags which affect the lookup.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39494">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificate_for_handle_async" c:identifier="g_tls_database_lookup_certificate_for_handle_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39516">Asynchronously look up a certificate by its handle in the database. See
|
|
g_tls_database_lookup_certificate_for_handle() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="188"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39518">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="handle" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39519">a certificate handle</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39520">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39521">Flags which affect the lookup.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39522">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39523">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39524">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificate_for_handle_finish" c:identifier="g_tls_database_lookup_certificate_for_handle_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39533">Finish an asynchronous lookup of a certificate by its handle. See
|
|
g_tls_database_lookup_certificate_for_handle() for more information.
|
|
|
|
If the handle is no longer valid, or does not point to a certificate in
|
|
this database, then %NULL will be returned.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="197"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39545">a newly allocated #GTlsCertificate object.
|
|
Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39535">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39536">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificate_issuer" c:identifier="g_tls_database_lookup_certificate_issuer" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39551">Look up the issuer of @certificate in the database.
|
|
|
|
The #GTlsCertificate:issuer property
|
|
of @certificate is not modified, and the two certificates are not hooked
|
|
into a chain.
|
|
|
|
This function can block, use g_tls_database_lookup_certificate_issuer_async() to perform
|
|
the lookup operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="202"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39569">a newly allocated issuer #GTlsCertificate,
|
|
or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39553">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39554">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39555">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39556">flags which affect the lookup operation</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39557">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificate_issuer_async" c:identifier="g_tls_database_lookup_certificate_issuer_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39575">Asynchronously look up the issuer of @certificate in the database. See
|
|
g_tls_database_lookup_certificate_issuer() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="210"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39577">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39578">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39579">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39580">flags which affect the lookup operation</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39581">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39582">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39583">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificate_issuer_finish" c:identifier="g_tls_database_lookup_certificate_issuer_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39592">Finish an asynchronous lookup issuer operation. See
|
|
g_tls_database_lookup_certificate_issuer() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="219"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39601">a newly allocated issuer #GTlsCertificate,
|
|
or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39594">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39595">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificates_issued_by" c:identifier="g_tls_database_lookup_certificates_issued_by" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39607">Look up certificates issued by this issuer in the database.
|
|
|
|
This function can block, use g_tls_database_lookup_certificates_issued_by_async() to perform
|
|
the lookup operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="224"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39621">a newly allocated list of #GTlsCertificate
|
|
objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="TlsCertificate"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39609">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="issuer_raw_dn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39610">a #GByteArray which holds the DER encoded issuer DN.</doc>
|
|
<array name="GLib.ByteArray" c:type="GByteArray*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39611">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39612">Flags which affect the lookup operation.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39613">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificates_issued_by_async" c:identifier="g_tls_database_lookup_certificates_issued_by_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39627">Asynchronously look up certificates issued by this issuer in the database. See
|
|
g_tls_database_lookup_certificates_issued_by() for more information.
|
|
|
|
The database may choose to hold a reference to the issuer byte array for the duration
|
|
of of this asynchronous operation. The byte array should not be modified during
|
|
this time.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="232"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39629">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="issuer_raw_dn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39630">a #GByteArray which holds the DER encoded issuer DN.</doc>
|
|
<array name="GLib.ByteArray" c:type="GByteArray*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39631">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39632">Flags which affect the lookup operation.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39633">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39634">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39635">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="lookup_certificates_issued_by_finish" c:identifier="g_tls_database_lookup_certificates_issued_by_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39648">Finish an asynchronous lookup of certificates. See
|
|
g_tls_database_lookup_certificates_issued_by() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="241"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39657">a newly allocated list of #GTlsCertificate
|
|
objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="TlsCertificate"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39650">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39651">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="verify_chain" c:identifier="g_tls_database_verify_chain" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39663">Determines the validity of a certificate chain after looking up and
|
|
adding any missing certificates to the chain.
|
|
|
|
@chain is a chain of #GTlsCertificate objects each pointing to the next
|
|
certificate in the chain by its #GTlsCertificate:issuer property. The chain may initially
|
|
consist of one or more certificates. After the verification process is
|
|
complete, @chain may be modified by adding missing certificates, or removing
|
|
extra certificates. If a certificate anchor was found, then it is added to
|
|
the @chain.
|
|
|
|
@purpose describes the purpose (or usage) for which the certificate
|
|
is being used. Typically @purpose will be set to #G_TLS_DATABASE_PURPOSE_AUTHENTICATE_SERVER
|
|
which means that the certificate is being used to authenticate a server
|
|
(and we are acting as the client).
|
|
|
|
The @identity is used to check for pinned certificates (trust exceptions)
|
|
in the database. These will override the normal verification process on a
|
|
host by host basis.
|
|
|
|
Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be
|
|
used.
|
|
|
|
If @chain is found to be valid, then the return value will be 0. If
|
|
@chain is found to be invalid, then the return value will indicate
|
|
the problems found. If the function is unable to determine whether
|
|
@chain is valid or not (eg, because @cancellable is triggered
|
|
before it completes) then the return value will be
|
|
%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
|
|
accordingly. @error is not set when @chain is successfully analyzed
|
|
but found to be invalid.
|
|
|
|
This function can block, use g_tls_database_verify_chain_async() to perform
|
|
the verification operation asynchronously.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="150"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39708">the appropriate #GTlsCertificateFlags which represents the
|
|
result of verification.</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39665">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="chain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39666">a #GTlsCertificate chain</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="purpose" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39667">the purpose that this certificate chain will be used for.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39668">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39669">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39670">additional verify flags</doc>
|
|
<type name="TlsDatabaseVerifyFlags" c:type="GTlsDatabaseVerifyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39671">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="verify_chain_async" c:identifier="g_tls_database_verify_chain_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39714">Asynchronously determines the validity of a certificate chain after
|
|
looking up and adding any missing certificates to the chain. See
|
|
g_tls_database_verify_chain() for more information.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="160"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39716">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="chain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39717">a #GTlsCertificate chain</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="purpose" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39718">the purpose that this certificate chain will be used for.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39719">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39720">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39721">additional verify flags</doc>
|
|
<type name="TlsDatabaseVerifyFlags" c:type="GTlsDatabaseVerifyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39722">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39723">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39724">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="verify_chain_finish" c:identifier="g_tls_database_verify_chain_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39734">Finish an asynchronous verify chain operation. See
|
|
g_tls_database_verify_chain() for more information.
|
|
|
|
If @chain is found to be valid, then the return value will be 0. If
|
|
@chain is found to be invalid, then the return value will indicate
|
|
the problems found. If the function is unable to determine whether
|
|
@chain is valid or not (eg, because @cancellable is triggered
|
|
before it completes) then the return value will be
|
|
%G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set
|
|
accordingly. @error is not set when @chain is successfully analyzed
|
|
but found to be invalid.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="171"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39752">the appropriate #GTlsCertificateFlags which represents the
|
|
result of verification.</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39736">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39737">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="TlsDatabasePrivate" c:type="GTlsDatabasePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="TlsDatabaseClass" c:type="GTlsDatabaseClass" glib:is-gtype-struct-for="TlsDatabase" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3896">The class for #GTlsDatabase. Derived classes should implement the various
|
|
virtual methods. _async and _finish methods have a default
|
|
implementation that runs the corresponding sync method in a thread.</doc>
|
|
<source-position filename="gtlsdatabase.h" line="144"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="verify_chain">
|
|
<callback name="verify_chain" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="58"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39708">the appropriate #GTlsCertificateFlags which represents the
|
|
result of verification.</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39665">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="chain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39666">a #GTlsCertificate chain</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="purpose" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39667">the purpose that this certificate chain will be used for.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39668">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39669">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39670">additional verify flags</doc>
|
|
<type name="TlsDatabaseVerifyFlags" c:type="GTlsDatabaseVerifyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39671">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="verify_chain_async">
|
|
<callback name="verify_chain_async">
|
|
<source-position filename="gtlsdatabase.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39716">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="chain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39717">a #GTlsCertificate chain</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="purpose" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39718">the purpose that this certificate chain will be used for.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39719">the expected peer identity</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39720">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39721">additional verify flags</doc>
|
|
<type name="TlsDatabaseVerifyFlags" c:type="GTlsDatabaseVerifyFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39722">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="8">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39723">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="8">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39724">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="verify_chain_finish">
|
|
<callback name="verify_chain_finish" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39752">the appropriate #GTlsCertificateFlags which represents the
|
|
result of verification.</doc>
|
|
<type name="TlsCertificateFlags" c:type="GTlsCertificateFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39736">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39737">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="create_certificate_handle">
|
|
<callback name="create_certificate_handle">
|
|
<source-position filename="gtlsdatabase.h" line="81"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39482">a newly allocated string containing the
|
|
handle.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39470">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39471">certificate for which to create a handle.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificate_for_handle">
|
|
<callback name="lookup_certificate_for_handle" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="84"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39510">a newly allocated
|
|
#GTlsCertificate, or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39490">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="handle" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39491">a certificate handle</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39492">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39493">Flags which affect the lookup.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39494">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificate_for_handle_async">
|
|
<callback name="lookup_certificate_for_handle_async">
|
|
<source-position filename="gtlsdatabase.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39518">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="handle" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39519">a certificate handle</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39520">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39521">Flags which affect the lookup.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39522">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39523">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39524">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificate_for_handle_finish">
|
|
<callback name="lookup_certificate_for_handle_finish" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39545">a newly allocated #GTlsCertificate object.
|
|
Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39535">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39536">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificate_issuer">
|
|
<callback name="lookup_certificate_issuer" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="103"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39569">a newly allocated issuer #GTlsCertificate,
|
|
or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39553">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39554">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39555">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39556">flags which affect the lookup operation</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39557">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificate_issuer_async">
|
|
<callback name="lookup_certificate_issuer_async">
|
|
<source-position filename="gtlsdatabase.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39577">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="certificate" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39578">a #GTlsCertificate</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39579">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39580">flags which affect the lookup operation</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39581">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39582">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39583">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificate_issuer_finish">
|
|
<callback name="lookup_certificate_issuer_finish" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="118"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39601">a newly allocated issuer #GTlsCertificate,
|
|
or %NULL. Use g_object_unref() to release the certificate.</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39594">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39595">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificates_issued_by">
|
|
<callback name="lookup_certificates_issued_by" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="122"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39621">a newly allocated list of #GTlsCertificate
|
|
objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="TlsCertificate"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39609">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="issuer_raw_dn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39610">a #GByteArray which holds the DER encoded issuer DN.</doc>
|
|
<array name="GLib.ByteArray" c:type="GByteArray*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39611">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39612">Flags which affect the lookup operation.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39613">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificates_issued_by_async">
|
|
<callback name="lookup_certificates_issued_by_async">
|
|
<source-position filename="gtlsdatabase.h" line="129"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39629">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="issuer_raw_dn" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39630">a #GByteArray which holds the DER encoded issuer DN.</doc>
|
|
<array name="GLib.ByteArray" c:type="GByteArray*">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="interaction" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39631">used to interact with the user if necessary</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39632">Flags which affect the lookup operation.</doc>
|
|
<type name="TlsDatabaseLookupFlags" c:type="GTlsDatabaseLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39633">a #GCancellable, or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39634">callback to call when the operation completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39635">the data to pass to the callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="lookup_certificates_issued_by_finish">
|
|
<callback name="lookup_certificates_issued_by_finish" throws="1">
|
|
<source-position filename="gtlsdatabase.h" line="137"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39657">a newly allocated list of #GTlsCertificate
|
|
objects. Use g_object_unref() on each certificate, and g_list_free() on the release the list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="TlsCertificate"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="self" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39650">a #GTlsDatabase</doc>
|
|
<type name="TlsDatabase" c:type="GTlsDatabase*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39651">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="16">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<enumeration name="TlsDatabaseLookupFlags" version="2.30" glib:type-name="GTlsDatabaseLookupFlags" glib:get-type="g_tls_database_lookup_flags_get_type" c:type="GTlsDatabaseLookupFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1723">Flags for g_tls_database_lookup_certificate_for_handle(),
|
|
g_tls_database_lookup_certificate_issuer(),
|
|
and g_tls_database_lookup_certificates_issued_by().</doc>
|
|
<member name="none" value="0" c:identifier="G_TLS_DATABASE_LOOKUP_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1725">No lookup flags</doc>
|
|
</member>
|
|
<member name="keypair" value="1" c:identifier="G_TLS_DATABASE_LOOKUP_KEYPAIR" glib:nick="keypair">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1726">Restrict lookup to certificates that have
|
|
a private key.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<record name="TlsDatabasePrivate" c:type="GTlsDatabasePrivate" disguised="1">
|
|
<source-position filename="gtlsdatabase.h" line="43"/>
|
|
</record>
|
|
<bitfield name="TlsDatabaseVerifyFlags" version="2.30" glib:type-name="GTlsDatabaseVerifyFlags" glib:get-type="g_tls_database_verify_flags_get_type" c:type="GTlsDatabaseVerifyFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1711">Flags for g_tls_database_verify_chain().</doc>
|
|
<member name="none" value="0" c:identifier="G_TLS_DATABASE_VERIFY_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1713">No verification flags</doc>
|
|
</member>
|
|
</bitfield>
|
|
<enumeration name="TlsError" version="2.28" glib:type-name="GTlsError" glib:get-type="g_tls_error_get_type" c:type="GTlsError" glib:error-domain="g-tls-error-quark">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1522">An error code used with %G_TLS_ERROR in a #GError returned from a
|
|
TLS-related routine.</doc>
|
|
<member name="unavailable" value="0" c:identifier="G_TLS_ERROR_UNAVAILABLE" glib:nick="unavailable">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1524">No TLS provider is available</doc>
|
|
</member>
|
|
<member name="misc" value="1" c:identifier="G_TLS_ERROR_MISC" glib:nick="misc">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1525">Miscellaneous TLS error</doc>
|
|
</member>
|
|
<member name="bad_certificate" value="2" c:identifier="G_TLS_ERROR_BAD_CERTIFICATE" glib:nick="bad-certificate">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1526">The certificate presented could not
|
|
be parsed or failed validation.</doc>
|
|
</member>
|
|
<member name="not_tls" value="3" c:identifier="G_TLS_ERROR_NOT_TLS" glib:nick="not-tls">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1528">The TLS handshake failed because the
|
|
peer does not seem to be a TLS server.</doc>
|
|
</member>
|
|
<member name="handshake" value="4" c:identifier="G_TLS_ERROR_HANDSHAKE" glib:nick="handshake">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1530">The TLS handshake failed because the
|
|
peer's certificate was not acceptable.</doc>
|
|
</member>
|
|
<member name="certificate_required" value="5" c:identifier="G_TLS_ERROR_CERTIFICATE_REQUIRED" glib:nick="certificate-required">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1532">The TLS handshake failed because
|
|
the server requested a client-side certificate, but none was
|
|
provided. See g_tls_connection_set_certificate().</doc>
|
|
</member>
|
|
<member name="eof" value="6" c:identifier="G_TLS_ERROR_EOF" glib:nick="eof">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1535">The TLS connection was closed without proper
|
|
notice, which may indicate an attack. See
|
|
g_tls_connection_set_require_close_notify().</doc>
|
|
</member>
|
|
<member name="inappropriate_fallback" value="7" c:identifier="G_TLS_ERROR_INAPPROPRIATE_FALLBACK" glib:nick="inappropriate-fallback">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1538">The TLS handshake failed
|
|
because the client sent the fallback SCSV, indicating a protocol
|
|
downgrade attack. Since: 2.60</doc>
|
|
</member>
|
|
<function name="quark" c:identifier="g_tls_error_quark" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39758">Gets the TLS error quark.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39763">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
</enumeration>
|
|
<interface name="TlsFileDatabase" c:symbol-prefix="tls_file_database" c:type="GTlsFileDatabase" version="2.30" glib:type-name="GTlsFileDatabase" glib:get-type="g_tls_file_database_get_type" glib:type-struct="TlsFileDatabaseInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9487">#GTlsFileDatabase is implemented by #GTlsDatabase objects which load
|
|
their certificate information from a file. It is an interface which
|
|
TLS library specific subtypes implement.</doc>
|
|
<source-position filename="gtlsfiledatabase.h" line="47"/>
|
|
<prerequisite name="TlsDatabase"/>
|
|
<function name="new" c:identifier="g_tls_file_database_new" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39768">Creates a new #GTlsFileDatabase which uses anchor certificate authorities
|
|
in @anchors to verify certificate chains.
|
|
|
|
The certificates in @anchors must be PEM encoded.</doc>
|
|
<source-position filename="gtlsfiledatabase.h" line="53"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39778">the new
|
|
#GTlsFileDatabase, or %NULL on error</doc>
|
|
<type name="TlsFileDatabase" c:type="GTlsDatabase*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="anchors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39770">filename of anchor certificate authorities.</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<property name="anchors" version="2.30" writable="1" construct="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3943">The path to a file containing PEM encoded certificate authority
|
|
root anchors. The certificates in this file will be treated as
|
|
root authorities for the purpose of verifying other certificates
|
|
via the g_tls_database_verify_chain() operation.</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
</interface>
|
|
<record name="TlsFileDatabaseInterface" c:type="GTlsFileDatabaseInterface" glib:is-gtype-struct-for="TlsFileDatabase">
|
|
<doc xml:space="preserve" filename="gtlsfiledatabase.h" line="33">Provides an interface for #GTlsFileDatabase implementations.</doc>
|
|
<source-position filename="gtlsfiledatabase.h" line="47"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gtlsfiledatabase.h" line="35">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="8">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<class name="TlsInteraction" c:symbol-prefix="tls_interaction" c:type="GTlsInteraction" version="2.30" parent="GObject.Object" glib:type-name="GTlsInteraction" glib:get-type="g_tls_interaction_get_type" glib:type-struct="TlsInteractionClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9500">#GTlsInteraction provides a mechanism for the TLS connection and database
|
|
code to interact with the user. It can be used to ask the user for passwords.
|
|
|
|
To use a #GTlsInteraction with a TLS connection use
|
|
g_tls_connection_set_interaction().
|
|
|
|
Callers should instantiate a derived class that implements the various
|
|
interaction methods to show the required dialogs.
|
|
|
|
Callers should use the 'invoke' functions like
|
|
g_tls_interaction_invoke_ask_password() to run interaction methods. These
|
|
functions make sure that the interaction is invoked in the main loop
|
|
and not in the current thread, if the current thread is not running the
|
|
main loop.
|
|
|
|
Derived classes can choose to implement whichever interactions methods they'd
|
|
like to support by overriding those virtual methods in their class
|
|
initialization function. Any interactions not implemented will return
|
|
%G_TLS_INTERACTION_UNHANDLED. If a derived class implements an async method,
|
|
it must also implement the corresponding finish method.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="90"/>
|
|
<virtual-method name="ask_password" invoker="ask_password" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39784">Run synchronous interaction to ask the user for a password. In general,
|
|
g_tls_interaction_invoke_ask_password() should be used instead of this
|
|
function.
|
|
|
|
Derived subclasses usually implement a password prompt, although they may
|
|
also choose to provide a password from elsewhere. The @password value will
|
|
be filled in and then @callback will be called. Alternatively the user may
|
|
abort this password request, which will usually abort the TLS connection.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39805">The status of the ask password interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39786">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39787">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39788">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="ask_password_async" invoker="ask_password_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39810">Run asynchronous interaction to ask the user for a password. In general,
|
|
g_tls_interaction_invoke_ask_password() should be used instead of this
|
|
function.
|
|
|
|
Derived subclasses usually implement a password prompt, although they may
|
|
also choose to provide a password from elsewhere. The @password value will
|
|
be filled in and then @callback will be called. Alternatively the user may
|
|
abort this password request, which will usually abort the TLS connection.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.
|
|
|
|
Certain implementations may not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39812">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39813">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39814">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39815">will be called when the interaction completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39816">data to pass to the @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="ask_password_finish" invoker="ask_password_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39838">Complete an ask password user interaction request. This should be once
|
|
the g_tls_interaction_ask_password_async() completion callback is called.
|
|
|
|
If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsPassword passed
|
|
to g_tls_interaction_ask_password() will have its password filled in.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39854">The status of the ask password interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39840">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39841">the result passed to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="request_certificate" invoker="request_certificate" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39925">Run synchronous interaction to ask the user to choose a certificate to use
|
|
with the connection. In general, g_tls_interaction_invoke_request_certificate()
|
|
should be used instead of this function.
|
|
|
|
Derived subclasses usually implement a certificate selector, although they may
|
|
also choose to provide a certificate from elsewhere. Alternatively the user may
|
|
abort this certificate request, which will usually abort the TLS connection.
|
|
|
|
If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection
|
|
passed to g_tls_interaction_request_certificate() will have had its
|
|
#GTlsConnection:certificate filled in.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39950">The status of the request certificate interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39927">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39928">a #GTlsConnection object</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39929">flags providing more information about the request</doc>
|
|
<type name="TlsCertificateRequestFlags" c:type="GTlsCertificateRequestFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39930">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="request_certificate_async" invoker="request_certificate_async" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39955">Run asynchronous interaction to ask the user for a certificate to use with
|
|
the connection. In general, g_tls_interaction_invoke_request_certificate() should
|
|
be used instead of this function.
|
|
|
|
Derived subclasses usually implement a certificate selector, although they may
|
|
also choose to provide a certificate from elsewhere. @callback will be called
|
|
when the operation completes. Alternatively the user may abort this certificate
|
|
request, which will usually abort the TLS connection.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39957">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39958">a #GTlsConnection object</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39959">flags providing more information about the request</doc>
|
|
<type name="TlsCertificateRequestFlags" c:type="GTlsCertificateRequestFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39960">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39961">will be called when the interaction completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39962">data to pass to the @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="request_certificate_finish" invoker="request_certificate_finish" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39977">Complete an request certificate user interaction request. This should be once
|
|
the g_tls_interaction_request_certificate_async() completion callback is called.
|
|
|
|
If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection
|
|
passed to g_tls_interaction_request_certificate_async() will have had its
|
|
#GTlsConnection:certificate filled in.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39994">The status of the request certificate interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39979">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39980">the result passed to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="ask_password" c:identifier="g_tls_interaction_ask_password" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39784">Run synchronous interaction to ask the user for a password. In general,
|
|
g_tls_interaction_invoke_ask_password() should be used instead of this
|
|
function.
|
|
|
|
Derived subclasses usually implement a password prompt, although they may
|
|
also choose to provide a password from elsewhere. The @password value will
|
|
be filled in and then @callback will be called. Alternatively the user may
|
|
abort this password request, which will usually abort the TLS connection.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39805">The status of the ask password interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39786">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39787">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39788">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ask_password_async" c:identifier="g_tls_interaction_ask_password_async" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39810">Run asynchronous interaction to ask the user for a password. In general,
|
|
g_tls_interaction_invoke_ask_password() should be used instead of this
|
|
function.
|
|
|
|
Derived subclasses usually implement a password prompt, although they may
|
|
also choose to provide a password from elsewhere. The @password value will
|
|
be filled in and then @callback will be called. Alternatively the user may
|
|
abort this password request, which will usually abort the TLS connection.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.
|
|
|
|
Certain implementations may not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39812">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39813">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39814">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39815">will be called when the interaction completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39816">data to pass to the @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="ask_password_finish" c:identifier="g_tls_interaction_ask_password_finish" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39838">Complete an ask password user interaction request. This should be once
|
|
the g_tls_interaction_ask_password_async() completion callback is called.
|
|
|
|
If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsPassword passed
|
|
to g_tls_interaction_ask_password() will have its password filled in.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39854">The status of the ask password interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39840">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39841">the result passed to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="invoke_ask_password" c:identifier="g_tls_interaction_invoke_ask_password" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39859">Invoke the interaction to ask the user for a password. It invokes this
|
|
interaction in the main loop, specifically the #GMainContext returned by
|
|
g_main_context_get_thread_default() when the interaction is created. This
|
|
is called by called by #GTlsConnection or #GTlsDatabase to ask the user
|
|
for a password.
|
|
|
|
Derived subclasses usually implement a password prompt, although they may
|
|
also choose to provide a password from elsewhere. The @password value will
|
|
be filled in and then @callback will be called. Alternatively the user may
|
|
abort this password request, which will usually abort the TLS connection.
|
|
|
|
The implementation can either be a synchronous (eg: modal dialog) or an
|
|
asynchronous one (eg: modeless dialog). This function will take care of
|
|
calling which ever one correctly.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39886">The status of the ask password interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39861">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39862">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39863">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="invoke_request_certificate" c:identifier="g_tls_interaction_invoke_request_certificate" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39891">Invoke the interaction to ask the user to choose a certificate to
|
|
use with the connection. It invokes this interaction in the main
|
|
loop, specifically the #GMainContext returned by
|
|
g_main_context_get_thread_default() when the interaction is
|
|
created. This is called by called by #GTlsConnection when the peer
|
|
requests a certificate during the handshake.
|
|
|
|
Derived subclasses usually implement a certificate selector,
|
|
although they may also choose to provide a certificate from
|
|
elsewhere. Alternatively the user may abort this certificate
|
|
request, which may or may not abort the TLS connection.
|
|
|
|
The implementation can either be a synchronous (eg: modal dialog) or an
|
|
asynchronous one (eg: modeless dialog). This function will take care of
|
|
calling which ever one correctly.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39920">The status of the certificate request interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39893">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39894">a #GTlsConnection object</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39895">flags providing more information about the request</doc>
|
|
<type name="TlsCertificateRequestFlags" c:type="GTlsCertificateRequestFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39896">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="request_certificate" c:identifier="g_tls_interaction_request_certificate" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39925">Run synchronous interaction to ask the user to choose a certificate to use
|
|
with the connection. In general, g_tls_interaction_invoke_request_certificate()
|
|
should be used instead of this function.
|
|
|
|
Derived subclasses usually implement a certificate selector, although they may
|
|
also choose to provide a certificate from elsewhere. Alternatively the user may
|
|
abort this certificate request, which will usually abort the TLS connection.
|
|
|
|
If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection
|
|
passed to g_tls_interaction_request_certificate() will have had its
|
|
#GTlsConnection:certificate filled in.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code. Certain implementations may
|
|
not support immediate cancellation.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="127"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39950">The status of the request certificate interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39927">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39928">a #GTlsConnection object</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39929">flags providing more information about the request</doc>
|
|
<type name="TlsCertificateRequestFlags" c:type="GTlsCertificateRequestFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39930">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="request_certificate_async" c:identifier="g_tls_interaction_request_certificate_async" version="2.40">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39955">Run asynchronous interaction to ask the user for a certificate to use with
|
|
the connection. In general, g_tls_interaction_invoke_request_certificate() should
|
|
be used instead of this function.
|
|
|
|
Derived subclasses usually implement a certificate selector, although they may
|
|
also choose to provide a certificate from elsewhere. @callback will be called
|
|
when the operation completes. Alternatively the user may abort this certificate
|
|
request, which will usually abort the TLS connection.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="134"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39957">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39958">a #GTlsConnection object</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39959">flags providing more information about the request</doc>
|
|
<type name="TlsCertificateRequestFlags" c:type="GTlsCertificateRequestFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39960">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39961">will be called when the interaction completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39962">data to pass to the @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="request_certificate_finish" c:identifier="g_tls_interaction_request_certificate_finish" version="2.40" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39977">Complete an request certificate user interaction request. This should be once
|
|
the g_tls_interaction_request_certificate_async() completion callback is called.
|
|
|
|
If %G_TLS_INTERACTION_HANDLED is returned, then the #GTlsConnection
|
|
passed to g_tls_interaction_request_certificate_async() will have had its
|
|
#GTlsConnection:certificate filled in.
|
|
|
|
If the interaction is cancelled by the cancellation object, or by the
|
|
user then %G_TLS_INTERACTION_FAILED will be returned with an error that
|
|
contains a %G_IO_ERROR_CANCELLED error code.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39994">The status of the request certificate interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39979">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39980">the result passed to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance" readable="0" private="1">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="TlsInteractionPrivate" c:type="GTlsInteractionPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="TlsInteractionClass" c:type="GTlsInteractionClass" glib:is-gtype-struct-for="TlsInteraction" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="3965">The class for #GTlsInteraction. Derived classes implement the various
|
|
virtual interaction methods to handle TLS interactions.
|
|
|
|
Derived classes can choose to implement whichever interactions methods they'd
|
|
like to support by overriding those virtual methods in their class
|
|
initialization function. If a derived class implements an async method,
|
|
it must also implement the corresponding finish method.
|
|
|
|
The synchronous interaction methods should implement to display modal dialogs,
|
|
and the asynchronous methods to display modeless dialogs.
|
|
|
|
If the user cancels an interaction, then the result should be
|
|
%G_TLS_INTERACTION_FAILED and the error should be set with a domain of
|
|
%G_IO_ERROR and code of %G_IO_ERROR_CANCELLED.</doc>
|
|
<source-position filename="gtlsinteraction.h" line="90"/>
|
|
<field name="parent_class" readable="0" private="1">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="ask_password">
|
|
<callback name="ask_password" throws="1">
|
|
<source-position filename="gtlsinteraction.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39805">The status of the ask password interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39786">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39787">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39788">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="ask_password_async">
|
|
<callback name="ask_password_async">
|
|
<source-position filename="gtlsinteraction.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39812">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39813">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39814">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39815">will be called when the interaction completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39816">data to pass to the @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="ask_password_finish">
|
|
<callback name="ask_password_finish" throws="1">
|
|
<source-position filename="gtlsinteraction.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39854">The status of the ask password interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39840">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39841">the result passed to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="request_certificate">
|
|
<callback name="request_certificate" throws="1">
|
|
<source-position filename="gtlsinteraction.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39950">The status of the request certificate interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39927">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39928">a #GTlsConnection object</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39929">flags providing more information about the request</doc>
|
|
<type name="TlsCertificateRequestFlags" c:type="GTlsCertificateRequestFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39930">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="request_certificate_async">
|
|
<callback name="request_certificate_async">
|
|
<source-position filename="gtlsinteraction.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39957">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39958">a #GTlsConnection object</doc>
|
|
<type name="TlsConnection" c:type="GTlsConnection*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39959">flags providing more information about the request</doc>
|
|
<type name="TlsCertificateRequestFlags" c:type="GTlsCertificateRequestFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39960">an optional #GCancellable cancellation object</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39961">will be called when the interaction completes</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39962">data to pass to the @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="request_certificate_finish">
|
|
<callback name="request_certificate_finish" throws="1">
|
|
<source-position filename="gtlsinteraction.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39994">The status of the request certificate interaction.</doc>
|
|
<type name="TlsInteractionResult" c:type="GTlsInteractionResult"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="interaction" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39979">a #GTlsInteraction object</doc>
|
|
<type name="TlsInteraction" c:type="GTlsInteraction*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39980">the result passed to the callback</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="21">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<record name="TlsInteractionPrivate" c:type="GTlsInteractionPrivate" disguised="1">
|
|
<source-position filename="gtlsinteraction.h" line="40"/>
|
|
</record>
|
|
<enumeration name="TlsInteractionResult" version="2.30" glib:type-name="GTlsInteractionResult" glib:get-type="g_tls_interaction_result_get_type" c:type="GTlsInteractionResult">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1655">#GTlsInteractionResult is returned by various functions in #GTlsInteraction
|
|
when finishing an interaction request.</doc>
|
|
<member name="unhandled" value="0" c:identifier="G_TLS_INTERACTION_UNHANDLED" glib:nick="unhandled">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1657">The interaction was unhandled (i.e. not
|
|
implemented).</doc>
|
|
</member>
|
|
<member name="handled" value="1" c:identifier="G_TLS_INTERACTION_HANDLED" glib:nick="handled">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1659">The interaction completed, and resulting data
|
|
is available.</doc>
|
|
</member>
|
|
<member name="failed" value="2" c:identifier="G_TLS_INTERACTION_FAILED" glib:nick="failed">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1661">The interaction has failed, or was cancelled.
|
|
and the operation should be aborted.</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="TlsPassword" c:symbol-prefix="tls_password" c:type="GTlsPassword" version="2.30" parent="GObject.Object" glib:type-name="GTlsPassword" glib:get-type="g_tls_password_get_type" glib:type-struct="TlsPasswordClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9528">Holds a password used in TLS.</doc>
|
|
<source-position filename="gtlspassword.h" line="77"/>
|
|
<constructor name="new" c:identifier="g_tls_password_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40050">Create a new #GTlsPassword object.</doc>
|
|
<source-position filename="gtlspassword.h" line="83"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40057">The newly allocated password object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40052">the password flags</doc>
|
|
<type name="TlsPasswordFlags" c:type="GTlsPasswordFlags"/>
|
|
</parameter>
|
|
<parameter name="description" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40053">description of what the password is for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<virtual-method name="get_default_warning">
|
|
<source-position filename="gtlspassword.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_value" invoker="get_value" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40021">Get the password value. If @length is not %NULL then it will be
|
|
filled in with the length of the password value. (Note that the
|
|
password value is not nul-terminated, so you can only pass %NULL
|
|
for @length in contexts where you know the password will have a
|
|
certain fixed length.)</doc>
|
|
<source-position filename="gtlspassword.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40032">The password value (owned by the password object).</doc>
|
|
<type name="guint8" c:type="const guchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40023">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="length" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40024">location to place the length of the password.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="set_value" invoker="set_value_full" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40101">Provide the value for this password.
|
|
|
|
The @value will be owned by the password object, and later freed using
|
|
the @destroy function callback.
|
|
|
|
Specify the @length, for a non-nul-terminated password. Pass -1 as
|
|
@length if using a nul-terminated password, and @length will be
|
|
calculated automatically. (Note that the terminating nul is not
|
|
considered part of the password in this case.)</doc>
|
|
<source-position filename="gtlspassword.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40103">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40104">the value for the password</doc>
|
|
<array length="1" zero-terminated="0" c:type="guchar*">
|
|
<type name="guint8" c:type="guchar"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40105">the length of the password, or -1</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40106">a function to use to free the password.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_description" c:identifier="g_tls_password_get_description" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39999">Get a description string about what the password will be used for.</doc>
|
|
<source-position filename="gtlspassword.h" line="106"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40005">The description of the password.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40001">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_flags" c:identifier="g_tls_password_get_flags" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40010">Get flags about the password.</doc>
|
|
<source-position filename="gtlspassword.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40016">The flags about the password.</doc>
|
|
<type name="TlsPasswordFlags" c:type="GTlsPasswordFlags"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40012">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_value" c:identifier="g_tls_password_get_value" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40021">Get the password value. If @length is not %NULL then it will be
|
|
filled in with the length of the password value. (Note that the
|
|
password value is not nul-terminated, so you can only pass %NULL
|
|
for @length in contexts where you know the password will have a
|
|
certain fixed length.)</doc>
|
|
<source-position filename="gtlspassword.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40032">The password value (owned by the password object).</doc>
|
|
<type name="guint8" c:type="const guchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40023">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="length" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40024">location to place the length of the password.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_warning" c:identifier="g_tls_password_get_warning" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40037">Get a user readable translated warning. Usually this warning is a
|
|
representation of the password flags returned from
|
|
g_tls_password_get_flags().</doc>
|
|
<source-position filename="gtlspassword.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40045">The warning.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40039">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_description" c:identifier="g_tls_password_set_description" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40061">Set a description string about what the password will be used for.</doc>
|
|
<source-position filename="gtlspassword.h" line="108"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40063">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="description" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40064">The description of the password</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_flags" c:identifier="g_tls_password_set_flags" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40072">Set flags about the password.</doc>
|
|
<source-position filename="gtlspassword.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40074">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40075">The flags about the password</doc>
|
|
<type name="TlsPasswordFlags" c:type="GTlsPasswordFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_value" c:identifier="g_tls_password_set_value" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40083">Set the value for this password. The @value will be copied by the password
|
|
object.
|
|
|
|
Specify the @length, for a non-nul-terminated password. Pass -1 as
|
|
@length if using a nul-terminated password, and @length will be
|
|
calculated automatically. (Note that the terminating nul is not
|
|
considered part of the password in this case.)</doc>
|
|
<source-position filename="gtlspassword.h" line="90"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40085">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40086">the new password value</doc>
|
|
<array length="1" zero-terminated="0" c:type="const guchar*">
|
|
<type name="guint8" c:type="guchar"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40087">the length of the password, or -1</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_value_full" c:identifier="g_tls_password_set_value_full" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40101">Provide the value for this password.
|
|
|
|
The @value will be owned by the password object, and later freed using
|
|
the @destroy function callback.
|
|
|
|
Specify the @length, for a non-nul-terminated password. Pass -1 as
|
|
@length if using a nul-terminated password, and @length will be
|
|
calculated automatically. (Note that the terminating nul is not
|
|
considered part of the password in this case.)</doc>
|
|
<source-position filename="gtlspassword.h" line="94"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40103">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40104">the value for the password</doc>
|
|
<array length="1" zero-terminated="0" c:type="guchar*">
|
|
<type name="guint8" c:type="guchar"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40105">the length of the password, or -1</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40106">a function to use to free the password.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_warning" c:identifier="g_tls_password_set_warning" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40122">Set a user readable translated warning. Usually this warning is a
|
|
representation of the password flags returned from
|
|
g_tls_password_get_flags().</doc>
|
|
<source-position filename="gtlspassword.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40124">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</instance-parameter>
|
|
<parameter name="warning" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40125">The user readable warning</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="description" writable="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="flags" writable="1" transfer-ownership="none">
|
|
<type name="TlsPasswordFlags"/>
|
|
</property>
|
|
<property name="warning" writable="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="TlsPasswordPrivate" c:type="GTlsPasswordPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="TlsPasswordClass" c:type="GTlsPasswordClass" glib:is-gtype-struct-for="TlsPassword">
|
|
<doc xml:space="preserve" filename="gtlspassword.h" line="49">Class structure for #GTlsPassword.</doc>
|
|
<source-position filename="gtlspassword.h" line="77"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="get_value">
|
|
<callback name="get_value">
|
|
<source-position filename="gtlspassword.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40032">The password value (owned by the password object).</doc>
|
|
<type name="guint8" c:type="const guchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40023">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40024">location to place the length of the password.</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="set_value">
|
|
<callback name="set_value">
|
|
<source-position filename="gtlspassword.h" line="67"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40103">a #GTlsPassword object</doc>
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40104">the value for the password</doc>
|
|
<array length="2" zero-terminated="0" c:type="guchar*">
|
|
<type name="guint8" c:type="guchar"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="length" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40105">the length of the password, or -1</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</parameter>
|
|
<parameter name="destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40106">a function to use to free the password.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_default_warning">
|
|
<callback name="get_default_warning">
|
|
<source-position filename="gtlspassword.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="password" transfer-ownership="none">
|
|
<type name="TlsPassword" c:type="GTlsPassword*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="padding" readable="0" private="1">
|
|
<array zero-terminated="0" fixed-size="4">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</array>
|
|
</field>
|
|
</record>
|
|
<bitfield name="TlsPasswordFlags" version="2.30" glib:type-name="GTlsPasswordFlags" glib:get-type="g_tls_password_flags_get_type" c:type="GTlsPasswordFlags">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1633">Various flags for the password.</doc>
|
|
<member name="none" value="0" c:identifier="G_TLS_PASSWORD_NONE" glib:nick="none">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1635">No flags</doc>
|
|
</member>
|
|
<member name="retry" value="2" c:identifier="G_TLS_PASSWORD_RETRY" glib:nick="retry">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1636">The password was wrong, and the user should retry.</doc>
|
|
</member>
|
|
<member name="many_tries" value="4" c:identifier="G_TLS_PASSWORD_MANY_TRIES" glib:nick="many-tries">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1637">Hint to the user that the password has been
|
|
wrong many times, and the user may not have many chances left.</doc>
|
|
</member>
|
|
<member name="final_try" value="8" c:identifier="G_TLS_PASSWORD_FINAL_TRY" glib:nick="final-try">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1639">Hint to the user that this is the last try to get
|
|
this password right.</doc>
|
|
</member>
|
|
</bitfield>
|
|
<record name="TlsPasswordPrivate" c:type="GTlsPasswordPrivate" disguised="1">
|
|
<source-position filename="gtlspassword.h" line="40"/>
|
|
</record>
|
|
<enumeration name="TlsRehandshakeMode" version="2.28" deprecated="1" deprecated-version="2.60." glib:type-name="GTlsRehandshakeMode" glib:get-type="g_tls_rehandshake_mode_get_type" c:type="GTlsRehandshakeMode">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1612">When to allow rehandshaking. See
|
|
g_tls_connection_set_rehandshake_mode().</doc>
|
|
<doc-deprecated xml:space="preserve">Changing the rehandshake mode is no longer
|
|
required for compatibility. Also, rehandshaking has been removed
|
|
from the TLS protocol in TLS 1.3.</doc-deprecated>
|
|
<member name="never" value="0" c:identifier="G_TLS_REHANDSHAKE_NEVER" glib:nick="never">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1614">Never allow rehandshaking</doc>
|
|
</member>
|
|
<member name="safely" value="1" c:identifier="G_TLS_REHANDSHAKE_SAFELY" glib:nick="safely">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1615">Allow safe rehandshaking only</doc>
|
|
</member>
|
|
<member name="unsafely" value="2" c:identifier="G_TLS_REHANDSHAKE_UNSAFELY" glib:nick="unsafely">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="1616">Allow unsafe rehandshaking</doc>
|
|
</member>
|
|
</enumeration>
|
|
<interface name="TlsServerConnection" c:symbol-prefix="tls_server_connection" c:type="GTlsServerConnection" version="2.28" glib:type-name="GTlsServerConnection" glib:get-type="g_tls_server_connection_get_type" glib:type-struct="TlsServerConnectionInterface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9538">#GTlsServerConnection is the server-side subclass of #GTlsConnection,
|
|
representing a server-side TLS connection.</doc>
|
|
<source-position filename="gtlsserverconnection.h" line="57"/>
|
|
<prerequisite name="TlsConnection"/>
|
|
<function name="new" c:identifier="g_tls_server_connection_new" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40135">Creates a new #GTlsServerConnection wrapping @base_io_stream (which
|
|
must have pollable input and output streams).
|
|
|
|
See the documentation for #GTlsConnection:base-io-stream for restrictions
|
|
on when application code can run operations on the @base_io_stream after
|
|
this function has returned.</doc>
|
|
<source-position filename="gtlsserverconnection.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40148">the new
|
|
#GTlsServerConnection, or %NULL on error</doc>
|
|
<type name="TlsServerConnection" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_io_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40137">the #GIOStream to wrap</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="certificate" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40138">the default server certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<property name="authentication-mode" version="2.28" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4015">The #GTlsAuthenticationMode for the server. This can be changed
|
|
before calling g_tls_connection_handshake() if you want to
|
|
rehandshake with a different mode from the initial handshake.</doc>
|
|
<type name="TlsAuthenticationMode"/>
|
|
</property>
|
|
</interface>
|
|
<record name="TlsServerConnectionInterface" c:type="GTlsServerConnectionInterface" glib:is-gtype-struct-for="TlsServerConnection" version="2.26">
|
|
<doc xml:space="preserve" filename="gtlsserverconnection.h" line="45">vtable for a #GTlsServerConnection implementation.</doc>
|
|
<source-position filename="gtlsserverconnection.h" line="57"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gtlsserverconnection.h" line="47">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
</record>
|
|
<function-macro name="UNIX_CONNECTION" c:identifier="G_UNIX_CONNECTION" introspectable="0">
|
|
<source-position filename="gunixconnection.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_CONNECTION_CLASS" c:identifier="G_UNIX_CONNECTION_CLASS" introspectable="0">
|
|
<source-position filename="gunixconnection.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_CONNECTION_GET_CLASS" c:identifier="G_UNIX_CONNECTION_GET_CLASS" introspectable="0">
|
|
<source-position filename="gunixconnection.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_CREDENTIALS_MESSAGE" c:identifier="G_UNIX_CREDENTIALS_MESSAGE" introspectable="0">
|
|
<source-position filename="gunixcredentialsmessage.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_CREDENTIALS_MESSAGE_CLASS" c:identifier="G_UNIX_CREDENTIALS_MESSAGE_CLASS" introspectable="0">
|
|
<source-position filename="gunixcredentialsmessage.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="c">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_CREDENTIALS_MESSAGE_GET_CLASS" c:identifier="G_UNIX_CREDENTIALS_MESSAGE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gunixcredentialsmessage.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_FD_LIST" c:identifier="G_UNIX_FD_LIST" introspectable="0">
|
|
<source-position filename="gunixfdlist.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_FD_LIST_CLASS" c:identifier="G_UNIX_FD_LIST_CLASS" introspectable="0">
|
|
<source-position filename="gunixfdlist.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_FD_LIST_GET_CLASS" c:identifier="G_UNIX_FD_LIST_GET_CLASS" introspectable="0">
|
|
<source-position filename="gunixfdlist.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_FD_MESSAGE" c:identifier="G_UNIX_FD_MESSAGE" introspectable="0">
|
|
<source-position filename="gunixfdmessage.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_FD_MESSAGE_CLASS" c:identifier="G_UNIX_FD_MESSAGE_CLASS" introspectable="0">
|
|
<source-position filename="gunixfdmessage.h" line="32"/>
|
|
<parameters>
|
|
<parameter name="class">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_FD_MESSAGE_GET_CLASS" c:identifier="G_UNIX_FD_MESSAGE_GET_CLASS" introspectable="0">
|
|
<source-position filename="gunixfdmessage.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="inst">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_INPUT_STREAM" c:identifier="G_UNIX_INPUT_STREAM" introspectable="0">
|
|
<source-position filename="gunixinputstream.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_INPUT_STREAM_CLASS" c:identifier="G_UNIX_INPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gunixinputstream.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_INPUT_STREAM_GET_CLASS" c:identifier="G_UNIX_INPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gunixinputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_MOUNT_MONITOR" c:identifier="G_UNIX_MOUNT_MONITOR" introspectable="0">
|
|
<source-position filename="gunixmounts.h" line="61"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_MOUNT_MONITOR_CLASS" c:identifier="G_UNIX_MOUNT_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gunixmounts.h" line="62"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_OUTPUT_STREAM" c:identifier="G_UNIX_OUTPUT_STREAM" introspectable="0">
|
|
<source-position filename="gunixoutputstream.h" line="29"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_OUTPUT_STREAM_CLASS" c:identifier="G_UNIX_OUTPUT_STREAM_CLASS" introspectable="0">
|
|
<source-position filename="gunixoutputstream.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_OUTPUT_STREAM_GET_CLASS" c:identifier="G_UNIX_OUTPUT_STREAM_GET_CLASS" introspectable="0">
|
|
<source-position filename="gunixoutputstream.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_SOCKET_ADDRESS" c:identifier="G_UNIX_SOCKET_ADDRESS" introspectable="0">
|
|
<source-position filename="gunixsocketaddress.h" line="30"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_SOCKET_ADDRESS_CLASS" c:identifier="G_UNIX_SOCKET_ADDRESS_CLASS" introspectable="0">
|
|
<source-position filename="gunixsocketaddress.h" line="31"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="UNIX_SOCKET_ADDRESS_GET_CLASS" c:identifier="G_UNIX_SOCKET_ADDRESS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gunixsocketaddress.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="UnixConnection" c:symbol-prefix="unix_connection" c:type="GUnixConnection" version="2.22" parent="SocketConnection" glib:type-name="GUnixConnection" glib:get-type="g_unix_connection_get_type" glib:type-struct="UnixConnectionClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9550">This is the subclass of #GSocketConnection that is created
|
|
for UNIX domain sockets.
|
|
|
|
It contains functions to do some of the UNIX socket specific
|
|
functionality like passing file descriptors.
|
|
|
|
Note that `<gio/gunixconnection.h>` belongs to the UNIX-specific
|
|
GIO interfaces, thus you have to use the `gio-unix-2.0.pc`
|
|
pkg-config file when using it.</doc>
|
|
<source-position filename="gunixconnection.h" line="49"/>
|
|
<method name="receive_credentials" c:identifier="g_unix_connection_receive_credentials" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40154">Receives credentials from the sending end of the connection. The
|
|
sending end has to call g_unix_connection_send_credentials() (or
|
|
similar) for this to work.
|
|
|
|
As well as reading the credentials this also reads (and discards) a
|
|
single byte from the stream, as this is required for credentials
|
|
passing to work on some implementations.
|
|
|
|
This method can be expected to be available on the following platforms:
|
|
|
|
- Linux since GLib 2.26
|
|
- FreeBSD since GLib 2.26
|
|
- GNU/kFreeBSD since GLib 2.36
|
|
- Solaris, Illumos and OpenSolaris since GLib 2.40
|
|
- GNU/Hurd since GLib 2.40
|
|
|
|
Other ways to exchange credentials with a foreign peer includes the
|
|
#GUnixCredentialsMessage type and g_socket_get_credentials() function.</doc>
|
|
<source-position filename="gunixconnection.h" line="85"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40179">Received credentials on success (free with
|
|
g_object_unref()), %NULL if @error is set.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40156">A #GUnixConnection.</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40157">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_credentials_async" c:identifier="g_unix_connection_receive_credentials_async" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40185">Asynchronously receive credentials.
|
|
|
|
For more details, see g_unix_connection_receive_credentials() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can then call
|
|
g_unix_connection_receive_credentials_finish() to get the result of the operation.</doc>
|
|
<source-position filename="gunixconnection.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40187">A #GUnixConnection.</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40188">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40189">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40190">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_credentials_finish" c:identifier="g_unix_connection_receive_credentials_finish" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40204">Finishes an asynchronous receive credentials operation started with
|
|
g_unix_connection_receive_credentials_async().</doc>
|
|
<source-position filename="gunixconnection.h" line="94"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40213">a #GCredentials, or %NULL on error.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40206">A #GUnixConnection.</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40207">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="receive_fd" c:identifier="g_unix_connection_receive_fd" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40219">Receives a file descriptor from the sending end of the connection.
|
|
The sending end has to call g_unix_connection_send_fd() for this
|
|
to work.
|
|
|
|
As well as reading the fd this also reads a single byte from the
|
|
stream, as this is required for fd passing to work on some
|
|
implementations.</doc>
|
|
<source-position filename="gunixconnection.h" line="66"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40233">a file descriptor on success, -1 on error.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40221">a #GUnixConnection</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40222">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_credentials" c:identifier="g_unix_connection_send_credentials" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40238">Passes the credentials of the current user the receiving side
|
|
of the connection. The receiving end has to call
|
|
g_unix_connection_receive_credentials() (or similar) to accept the
|
|
credentials.
|
|
|
|
As well as sending the credentials this also writes a single NUL
|
|
byte to the stream, as this is required for credentials passing to
|
|
work on some implementations.
|
|
|
|
This method can be expected to be available on the following platforms:
|
|
|
|
- Linux since GLib 2.26
|
|
- FreeBSD since GLib 2.26
|
|
- GNU/kFreeBSD since GLib 2.36
|
|
- Solaris, Illumos and OpenSolaris since GLib 2.40
|
|
- GNU/Hurd since GLib 2.40
|
|
|
|
Other ways to exchange credentials with a foreign peer includes the
|
|
#GUnixCredentialsMessage type and g_socket_get_credentials() function.</doc>
|
|
<source-position filename="gunixconnection.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40264">%TRUE on success, %FALSE if @error is set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40240">A #GUnixConnection.</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40241">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_credentials_async" c:identifier="g_unix_connection_send_credentials_async" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40269">Asynchronously send credentials.
|
|
|
|
For more details, see g_unix_connection_send_credentials() which is
|
|
the synchronous version of this call.
|
|
|
|
When the operation is finished, @callback will be called. You can then call
|
|
g_unix_connection_send_credentials_finish() to get the result of the operation.</doc>
|
|
<source-position filename="gunixconnection.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40271">A #GUnixConnection.</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40272">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40273">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40274">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_credentials_finish" c:identifier="g_unix_connection_send_credentials_finish" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40288">Finishes an asynchronous send credentials operation started with
|
|
g_unix_connection_send_credentials_async().</doc>
|
|
<source-position filename="gunixconnection.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40297">%TRUE if the operation was successful, otherwise %FALSE.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40290">A #GUnixConnection.</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40291">a #GAsyncResult.</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="send_fd" c:identifier="g_unix_connection_send_fd" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40302">Passes a file descriptor to the receiving side of the
|
|
connection. The receiving end has to call g_unix_connection_receive_fd()
|
|
to accept the file descriptor.
|
|
|
|
As well as sending the fd this also writes a single byte to the
|
|
stream, as this is required for fd passing to work on some
|
|
implementations.</doc>
|
|
<source-position filename="gunixconnection.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40317">a %TRUE on success, %NULL on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40304">a #GUnixConnection</doc>
|
|
<type name="UnixConnection" c:type="GUnixConnection*"/>
|
|
</instance-parameter>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40305">a file descriptor</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40306">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="SocketConnection" c:type="GSocketConnection"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="UnixConnectionPrivate" c:type="GUnixConnectionPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="UnixConnectionClass" c:type="GUnixConnectionClass" glib:is-gtype-struct-for="UnixConnection">
|
|
<source-position filename="gunixconnection.h" line="49"/>
|
|
<field name="parent_class">
|
|
<type name="SocketConnectionClass" c:type="GSocketConnectionClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="UnixConnectionPrivate" c:type="GUnixConnectionPrivate" disguised="1">
|
|
<source-position filename="gunixconnection.h" line="41"/>
|
|
</record>
|
|
<class name="UnixCredentialsMessage" c:symbol-prefix="unix_credentials_message" c:type="GUnixCredentialsMessage" version="2.26" parent="SocketControlMessage" glib:type-name="GUnixCredentialsMessage" glib:get-type="g_unix_credentials_message_get_type" glib:type-struct="UnixCredentialsMessageClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9571">This #GSocketControlMessage contains a #GCredentials instance. It
|
|
may be sent using g_socket_send_message() and received using
|
|
g_socket_receive_message() over UNIX sockets (ie: sockets in the
|
|
%G_SOCKET_FAMILY_UNIX family).
|
|
|
|
For an easier way to send and receive credentials over
|
|
stream-oriented UNIX sockets, see
|
|
g_unix_connection_send_credentials() and
|
|
g_unix_connection_receive_credentials(). To receive credentials of
|
|
a foreign process connected to a socket, use
|
|
g_socket_get_credentials().</doc>
|
|
<source-position filename="gunixcredentialsmessage.h" line="57"/>
|
|
<constructor name="new" c:identifier="g_unix_credentials_message_new" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40343">Creates a new #GUnixCredentialsMessage with credentials matching the current processes.</doc>
|
|
<source-position filename="gunixcredentialsmessage.h" line="76"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40348">a new #GUnixCredentialsMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<constructor name="new_with_credentials" c:identifier="g_unix_credentials_message_new_with_credentials" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40353">Creates a new #GUnixCredentialsMessage holding @credentials.</doc>
|
|
<source-position filename="gunixcredentialsmessage.h" line="78"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40359">a new #GUnixCredentialsMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="credentials" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40355">A #GCredentials object.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="is_supported" c:identifier="g_unix_credentials_message_is_supported" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40333">Checks if passing #GCredentials on a #GSocket is supported on this platform.</doc>
|
|
<source-position filename="gunixcredentialsmessage.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40338">%TRUE if supported, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
</function>
|
|
<method name="get_credentials" c:identifier="g_unix_credentials_message_get_credentials" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40322">Gets the credentials stored in @message.</doc>
|
|
<source-position filename="gunixcredentialsmessage.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40328">A #GCredentials instance. Do not free, it is owned by @message.</doc>
|
|
<type name="Credentials" c:type="GCredentials*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40324">A #GUnixCredentialsMessage.</doc>
|
|
<type name="UnixCredentialsMessage" c:type="GUnixCredentialsMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="credentials" version="2.26" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4034">The credentials stored in the message.</doc>
|
|
<type name="Credentials"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="UnixCredentialsMessagePrivate" c:type="GUnixCredentialsMessagePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="UnixCredentialsMessageClass" c:type="GUnixCredentialsMessageClass" glib:is-gtype-struct-for="UnixCredentialsMessage" version="2.26">
|
|
<doc xml:space="preserve" filename="gunixcredentialsmessage.h" line="41">Class structure for #GUnixCredentialsMessage.</doc>
|
|
<source-position filename="gunixcredentialsmessage.h" line="57"/>
|
|
<field name="parent_class">
|
|
<type name="SocketControlMessageClass" c:type="GSocketControlMessageClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gunixcredentialsmessage.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gunixcredentialsmessage.h" line="56"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="UnixCredentialsMessagePrivate" c:type="GUnixCredentialsMessagePrivate" disguised="1">
|
|
<source-position filename="gunixcredentialsmessage.h" line="36"/>
|
|
</record>
|
|
<class name="UnixFDList" c:symbol-prefix="unix_fd_list" c:type="GUnixFDList" parent="GObject.Object" glib:type-name="GUnixFDList" glib:get-type="g_unix_fd_list_get_type" glib:type-struct="UnixFDListClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9592">A #GUnixFDList contains a list of file descriptors. It owns the file
|
|
descriptors that it contains, closing them when finalized.
|
|
|
|
It may be wrapped in a #GUnixFDMessage and sent over a #GSocket in
|
|
the %G_SOCKET_FAMILY_UNIX family by using g_socket_send_message()
|
|
and received using g_socket_receive_message().
|
|
|
|
Note that `<gio/gunixfdlist.h>` belongs to the UNIX-specific GIO
|
|
interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config
|
|
file when using it.</doc>
|
|
<source-position filename="gunixfdlist.h" line="56"/>
|
|
<constructor name="new" c:identifier="g_unix_fd_list_new" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40425">Creates a new #GUnixFDList containing no file descriptors.</doc>
|
|
<source-position filename="gunixfdlist.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40430">a new #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<constructor name="new_from_array" c:identifier="g_unix_fd_list_new_from_array" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40435">Creates a new #GUnixFDList containing the file descriptors given in
|
|
@fds. The file descriptors become the property of the new list and
|
|
may no longer be used by the caller. The array itself is owned by
|
|
the caller.
|
|
|
|
Each file descriptor in the array should be set to close-on-exec.
|
|
|
|
If @n_fds is -1 then @fds must be terminated with -1.</doc>
|
|
<source-position filename="gunixfdlist.h" line="69"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40449">a new #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="fds" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40437">the initial list of file descriptors</doc>
|
|
<array length="1" zero-terminated="0" c:type="const gint*">
|
|
<type name="gint" c:type="gint"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="n_fds" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40438">the length of #fds, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="append" c:identifier="g_unix_fd_list_append" version="2.24" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40364">Adds a file descriptor to @list.
|
|
|
|
The file descriptor is duplicated using dup(). You keep your copy
|
|
of the descriptor and the copy contained in @list will be closed
|
|
when @list is finalized.
|
|
|
|
A possible cause of failure is exceeding the per-process or
|
|
system-wide file descriptor limit.
|
|
|
|
The index of the file descriptor in the list is returned. If you use
|
|
this index with g_unix_fd_list_get() then you will receive back a
|
|
duplicated copy of the same file descriptor.</doc>
|
|
<source-position filename="gunixfdlist.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40383">the index of the appended fd in case of success, else -1
|
|
(and @error is set)</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40366">a #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</instance-parameter>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40367">a valid open file descriptor</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get" c:identifier="g_unix_fd_list_get" version="2.24" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40389">Gets a file descriptor out of @list.
|
|
|
|
@index_ specifies the index of the file descriptor to get. It is a
|
|
programmer error for @index_ to be out of range; see
|
|
g_unix_fd_list_get_length().
|
|
|
|
The file descriptor is duplicated using dup() and set as
|
|
close-on-exec before being returned. You must call close() on it
|
|
when you are done.
|
|
|
|
A possible cause of failure is exceeding the per-process or
|
|
system-wide file descriptor limit.</doc>
|
|
<source-position filename="gunixfdlist.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40408">the file descriptor, or -1 in case of error</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40391">a #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</instance-parameter>
|
|
<parameter name="index_" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40392">the index into the list</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_length" c:identifier="g_unix_fd_list_get_length" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40413">Gets the length of @list (ie: the number of file descriptors
|
|
contained within).</doc>
|
|
<source-position filename="gunixfdlist.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40420">the length of @list</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40415">a #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="peek_fds" c:identifier="g_unix_fd_list_peek_fds" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40454">Returns the array of file descriptors that is contained in this
|
|
object.
|
|
|
|
After this call, the descriptors remain the property of @list. The
|
|
caller must not close them and must not free the array. The array is
|
|
valid only until @list is changed in any way.
|
|
|
|
If @length is non-%NULL then it is set to the number of file
|
|
descriptors in the returned array. The returned array is also
|
|
terminated with -1.
|
|
|
|
This function never returns %NULL. In case there are no file
|
|
descriptors contained in @list, an empty array is returned.</doc>
|
|
<source-position filename="gunixfdlist.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40474">an array of file
|
|
descriptors</doc>
|
|
<array length="0" zero-terminated="0" c:type="const gint*">
|
|
<type name="gint" c:type="gint"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40456">a #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</instance-parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40457">pointer to the length of the returned
|
|
array, or %NULL</doc>
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="steal_fds" c:identifier="g_unix_fd_list_steal_fds" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40480">Returns the array of file descriptors that is contained in this
|
|
object.
|
|
|
|
After this call, the descriptors are no longer contained in
|
|
@list. Further calls will return an empty list (unless more
|
|
descriptors have been added).
|
|
|
|
The return result of this function must be freed with g_free().
|
|
The caller is also responsible for closing all of the file
|
|
descriptors. The file descriptors in the array are set to
|
|
close-on-exec.
|
|
|
|
If @length is non-%NULL then it is set to the number of file
|
|
descriptors in the returned array. The returned array is also
|
|
terminated with -1.
|
|
|
|
This function never returns %NULL. In case there are no file
|
|
descriptors contained in @list, an empty array is returned.</doc>
|
|
<source-position filename="gunixfdlist.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40505">an array of file
|
|
descriptors</doc>
|
|
<array length="0" zero-terminated="0" c:type="gint*">
|
|
<type name="gint" c:type="gint"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40482">a #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</instance-parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40483">pointer to the length of the returned
|
|
array, or %NULL</doc>
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="UnixFDListPrivate" c:type="GUnixFDListPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="UnixFDListClass" c:type="GUnixFDListClass" glib:is-gtype-struct-for="UnixFDList">
|
|
<source-position filename="gunixfdlist.h" line="56"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gunixfdlist.h" line="51"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gunixfdlist.h" line="52"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gunixfdlist.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gunixfdlist.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gunixfdlist.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="UnixFDListPrivate" c:type="GUnixFDListPrivate" disguised="1">
|
|
<source-position filename="gunixfdlist.h" line="41"/>
|
|
</record>
|
|
<class name="UnixFDMessage" c:symbol-prefix="unix_fd_message" c:type="GUnixFDMessage" parent="SocketControlMessage" glib:type-name="GUnixFDMessage" glib:get-type="g_unix_fd_message_get_type" glib:type-struct="UnixFDMessageClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9612">This #GSocketControlMessage contains a #GUnixFDList.
|
|
It may be sent using g_socket_send_message() and received using
|
|
g_socket_receive_message() over UNIX sockets (ie: sockets in the
|
|
%G_SOCKET_FAMILY_UNIX family). The file descriptors are copied
|
|
between processes by the kernel.
|
|
|
|
For an easier way to send and receive file descriptors over
|
|
stream-oriented UNIX sockets, see g_unix_connection_send_fd() and
|
|
g_unix_connection_receive_fd().
|
|
|
|
Note that `<gio/gunixfdmessage.h>` belongs to the UNIX-specific GIO
|
|
interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config
|
|
file when using it.</doc>
|
|
<source-position filename="gunixfdmessage.h" line="56"/>
|
|
<constructor name="new" c:identifier="g_unix_fd_message_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40544">Creates a new #GUnixFDMessage containing an empty file descriptor
|
|
list.</doc>
|
|
<source-position filename="gunixfdmessage.h" line="69"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40550">a new #GUnixFDMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<constructor name="new_with_fd_list" c:identifier="g_unix_fd_message_new_with_fd_list" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40555">Creates a new #GUnixFDMessage containing @list.</doc>
|
|
<source-position filename="gunixfdmessage.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40561">a new #GUnixFDMessage</doc>
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="fd_list" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40557">a #GUnixFDList</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="append_fd" c:identifier="g_unix_fd_message_append_fd" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40511">Adds a file descriptor to @message.
|
|
|
|
The file descriptor is duplicated using dup(). You keep your copy
|
|
of the descriptor and the copy contained in @message will be closed
|
|
when @message is finalized.
|
|
|
|
A possible cause of failure is exceeding the per-process or
|
|
system-wide file descriptor limit.</doc>
|
|
<source-position filename="gunixfdmessage.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40526">%TRUE in case of success, else %FALSE (and @error is set)</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40513">a #GUnixFDMessage</doc>
|
|
<type name="UnixFDMessage" c:type="GUnixFDMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40514">a valid open file descriptor</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_fd_list" c:identifier="g_unix_fd_message_get_fd_list" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40531">Gets the #GUnixFDList contained in @message. This function does not
|
|
return a reference to the caller, but the returned list is valid for
|
|
the lifetime of @message.</doc>
|
|
<source-position filename="gunixfdmessage.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40539">the #GUnixFDList from @message</doc>
|
|
<type name="UnixFDList" c:type="GUnixFDList*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40533">a #GUnixFDMessage</doc>
|
|
<type name="UnixFDMessage" c:type="GUnixFDMessage*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="steal_fds" c:identifier="g_unix_fd_message_steal_fds" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40566">Returns the array of file descriptors that is contained in this
|
|
object.
|
|
|
|
After this call, the descriptors are no longer contained in
|
|
@message. Further calls will return an empty list (unless more
|
|
descriptors have been added).
|
|
|
|
The return result of this function must be freed with g_free().
|
|
The caller is also responsible for closing all of the file
|
|
descriptors.
|
|
|
|
If @length is non-%NULL then it is set to the number of file
|
|
descriptors in the returned array. The returned array is also
|
|
terminated with -1.
|
|
|
|
This function never returns %NULL. In case there are no file
|
|
descriptors contained in @message, an empty array is returned.</doc>
|
|
<source-position filename="gunixfdmessage.h" line="75"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40590">an array of file
|
|
descriptors</doc>
|
|
<array length="0" zero-terminated="0" c:type="gint*">
|
|
<type name="gint" c:type="gint"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40568">a #GUnixFDMessage</doc>
|
|
<type name="UnixFDMessage" c:type="GUnixFDMessage*"/>
|
|
</instance-parameter>
|
|
<parameter name="length" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40569">pointer to the length of the returned
|
|
array, or %NULL</doc>
|
|
<type name="gint" c:type="gint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="fd-list" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="UnixFDList"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="SocketControlMessage" c:type="GSocketControlMessage"/>
|
|
</field>
|
|
<field name="priv">
|
|
<type name="UnixFDMessagePrivate" c:type="GUnixFDMessagePrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="UnixFDMessageClass" c:type="GUnixFDMessageClass" glib:is-gtype-struct-for="UnixFDMessage">
|
|
<source-position filename="gunixfdmessage.h" line="56"/>
|
|
<field name="parent_class">
|
|
<type name="SocketControlMessageClass" c:type="GSocketControlMessageClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gunixfdmessage.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gunixfdmessage.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="UnixFDMessagePrivate" c:type="GUnixFDMessagePrivate" disguised="1">
|
|
<source-position filename="gunixfdmessage.h" line="41"/>
|
|
</record>
|
|
<class name="UnixInputStream" c:symbol-prefix="unix_input_stream" c:type="GUnixInputStream" parent="InputStream" glib:type-name="GUnixInputStream" glib:get-type="g_unix_input_stream_get_type" glib:type-struct="UnixInputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9635">#GUnixInputStream implements #GInputStream for reading from a UNIX
|
|
file descriptor, including asynchronous operations. (If the file
|
|
descriptor refers to a socket or pipe, this will use poll() to do
|
|
asynchronous I/O. If it refers to a regular file, it will fall back
|
|
to doing asynchronous I/O in another thread.)
|
|
|
|
Note that `<gio/gunixinputstream.h>` belongs to the UNIX-specific GIO
|
|
interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config
|
|
file when using it.</doc>
|
|
<source-position filename="gunixinputstream.h" line="65"/>
|
|
<implements name="FileDescriptorBased"/>
|
|
<implements name="PollableInputStream"/>
|
|
<constructor name="new" c:identifier="g_unix_input_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40619">Creates a new #GUnixInputStream for the given @fd.
|
|
|
|
If @close_fd is %TRUE, the file descriptor will be closed
|
|
when the stream is closed.</doc>
|
|
<source-position filename="gunixinputstream.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40629">a new #GUnixInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40621">a UNIX file descriptor</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="close_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40622">%TRUE to close the file descriptor when done</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_close_fd" c:identifier="g_unix_input_stream_get_close_fd" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40596">Returns whether the file descriptor of @stream will be
|
|
closed when the stream is closed.</doc>
|
|
<source-position filename="gunixinputstream.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40603">%TRUE if the file descriptor is closed when done</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40598">a #GUnixInputStream</doc>
|
|
<type name="UnixInputStream" c:type="GUnixInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_fd" c:identifier="g_unix_input_stream_get_fd" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40608">Return the UNIX file descriptor that the stream reads from.</doc>
|
|
<source-position filename="gunixinputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40614">The file descriptor of @stream</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40610">a #GUnixInputStream</doc>
|
|
<type name="UnixInputStream" c:type="GUnixInputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_close_fd" c:identifier="g_unix_input_stream_set_close_fd" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40633">Sets whether the file descriptor of @stream shall be closed
|
|
when the stream is closed.</doc>
|
|
<source-position filename="gunixinputstream.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40635">a #GUnixInputStream</doc>
|
|
<type name="UnixInputStream" c:type="GUnixInputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="close_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40636">%TRUE to close the file descriptor when done</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="close-fd" version="2.20" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4059">Whether to close the file descriptor when the stream is closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="fd" version="2.20" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4068">The file descriptor that the stream reads from.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="InputStream" c:type="GInputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="UnixInputStreamPrivate" c:type="GUnixInputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="UnixInputStreamClass" c:type="GUnixInputStreamClass" glib:is-gtype-struct-for="UnixInputStream">
|
|
<source-position filename="gunixinputstream.h" line="65"/>
|
|
<field name="parent_class">
|
|
<type name="InputStreamClass" c:type="GInputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gunixinputstream.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gunixinputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gunixinputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gunixinputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gunixinputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="UnixInputStreamPrivate" c:type="GUnixInputStreamPrivate" disguised="1">
|
|
<source-position filename="gunixinputstream.h" line="42"/>
|
|
</record>
|
|
<record name="UnixMountEntry" c:type="GUnixMountEntry" glib:type-name="GUnixMountEntry" glib:get-type="g_unix_mount_entry_get_type" c:symbol-prefix="unix_mount_entry">
|
|
<doc xml:space="preserve" filename="gunixmounts.h" line="28">Defines a Unix mount entry (e.g. <filename>/media/cdrom</filename>).
|
|
This corresponds roughly to a mtab entry.</doc>
|
|
<source-position filename="gunixmounts.h" line="34"/>
|
|
</record>
|
|
<class name="UnixMountMonitor" c:symbol-prefix="unix_mount_monitor" c:type="GUnixMountMonitor" parent="GObject.Object" glib:type-name="GUnixMountMonitor" glib:get-type="g_unix_mount_monitor_get_type" glib:type-struct="UnixMountMonitorClass">
|
|
<doc xml:space="preserve" filename="gunixmounts.h" line="52">Watches #GUnixMounts for changes.</doc>
|
|
<source-position filename="gunixmounts.h" line="58"/>
|
|
<constructor name="new" c:identifier="g_unix_mount_monitor_new" deprecated="1" deprecated-version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40927">Deprecated alias for g_unix_mount_monitor_get().
|
|
|
|
This function was never a true constructor, which is why it was
|
|
renamed.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_unix_mount_monitor_get() instead.</doc-deprecated>
|
|
<source-position filename="gunixmounts.h" line="153"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40935">a #GUnixMountMonitor.</doc>
|
|
<type name="UnixMountMonitor" c:type="GUnixMountMonitor*"/>
|
|
</return-value>
|
|
</constructor>
|
|
<function name="get" c:identifier="g_unix_mount_monitor_get" version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40909">Gets the #GUnixMountMonitor for the current thread-default main
|
|
context.
|
|
|
|
The mount monitor can be used to monitor for changes to the list of
|
|
mounted filesystems as well as the list of mount points (ie: fstab
|
|
entries).
|
|
|
|
You must only call g_object_unref() on the return value from under
|
|
the same main context as you called this function.</doc>
|
|
<source-position filename="gunixmounts.h" line="151"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40922">the #GUnixMountMonitor.</doc>
|
|
<type name="UnixMountMonitor" c:type="GUnixMountMonitor*"/>
|
|
</return-value>
|
|
</function>
|
|
<method name="set_rate_limit" c:identifier="g_unix_mount_monitor_set_rate_limit" version="2.18" deprecated="1" deprecated-version="2.44">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40940">This function does nothing.
|
|
|
|
Before 2.44, this was a partially-effective way of controlling the
|
|
rate at which events would be reported under some uncommon
|
|
circumstances. Since @mount_monitor is a singleton, it also meant
|
|
that calling this function would have side effects for other users of
|
|
the monitor.</doc>
|
|
<doc-deprecated xml:space="preserve">This function does nothing. Don't call it.</doc-deprecated>
|
|
<source-position filename="gunixmounts.h" line="155"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40942">a #GUnixMountMonitor</doc>
|
|
<type name="UnixMountMonitor" c:type="GUnixMountMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="limit_msec" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40943">a integer with the limit in milliseconds to
|
|
poll for changes.</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="mountpoints-changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4077">Emitted when the unix mount points have changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="mounts-changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4085">Emitted when the unix mounts have changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="UnixMountMonitorClass" c:type="GUnixMountMonitorClass" disguised="1" glib:is-gtype-struct-for="UnixMountMonitor">
|
|
<source-position filename="gunixmounts.h" line="58"/>
|
|
</record>
|
|
<record name="UnixMountPoint" c:type="GUnixMountPoint" glib:type-name="GUnixMountPoint" glib:get-type="g_unix_mount_point_get_type" c:symbol-prefix="unix_mount_point">
|
|
<doc xml:space="preserve" filename="gunixmounts.h" line="40">Defines a Unix mount point (e.g. <filename>/dev</filename>).
|
|
This corresponds roughly to a fstab entry.</doc>
|
|
<source-position filename="gunixmounts.h" line="46"/>
|
|
<method name="compare" c:identifier="g_unix_mount_point_compare">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40959">Compares two unix mount points.</doc>
|
|
<source-position filename="gunixmounts.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40966">1, 0 or -1 if @mount1 is greater than, equal to,
|
|
or less than @mount2, respectively.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40961">a #GUnixMount.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
<parameter name="mount2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40962">a #GUnixMount.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="copy" c:identifier="g_unix_mount_point_copy" version="2.54">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40971">Makes a copy of @mount_point.</doc>
|
|
<source-position filename="gunixmounts.h" line="74"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40977">a new #GUnixMountPoint</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40973">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="free" c:identifier="g_unix_mount_point_free">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40982">Frees a unix mount point.</doc>
|
|
<source-position filename="gunixmounts.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40984">unix mount point to free.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_device_path" c:identifier="g_unix_mount_point_get_device_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40990">Gets the device path for a unix mount point.</doc>
|
|
<source-position filename="gunixmounts.h" line="112"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40996">a string containing the device path.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40992">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_fs_type" c:identifier="g_unix_mount_point_get_fs_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41000">Gets the file system type for the mount point.</doc>
|
|
<source-position filename="gunixmounts.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41006">a string containing the file system type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41002">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_mount_path" c:identifier="g_unix_mount_point_get_mount_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41010">Gets the mount path for a unix mount point.</doc>
|
|
<source-position filename="gunixmounts.h" line="110"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41016">a string containing the mount path.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41012">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_options" c:identifier="g_unix_mount_point_get_options" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41020">Gets the options for the mount point.</doc>
|
|
<source-position filename="gunixmounts.h" line="116"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41026">a string containing the options.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41022">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="guess_can_eject" c:identifier="g_unix_mount_point_guess_can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41031">Guesses whether a Unix mount point can be ejected.</doc>
|
|
<source-position filename="gunixmounts.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41037">%TRUE if @mount_point is deemed to be ejectable.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41033">a #GUnixMountPoint</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="guess_icon" c:identifier="g_unix_mount_point_guess_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41041">Guesses the icon of a Unix mount point.</doc>
|
|
<source-position filename="gunixmounts.h" line="128"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41047">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41043">a #GUnixMountPoint</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="guess_name" c:identifier="g_unix_mount_point_guess_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41051">Guesses the name of a Unix mount point.
|
|
The result is a translated string.</doc>
|
|
<source-position filename="gunixmounts.h" line="126"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41058">A newly allocated string that must
|
|
be freed with g_free()</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41053">a #GUnixMountPoint</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="guess_symbolic_icon" c:identifier="g_unix_mount_point_guess_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41063">Guesses the symbolic icon of a Unix mount point.</doc>
|
|
<source-position filename="gunixmounts.h" line="130"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41069">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41065">a #GUnixMountPoint</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_loopback" c:identifier="g_unix_mount_point_is_loopback">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41086">Checks if a unix mount point is a loopback device.</doc>
|
|
<source-position filename="gunixmounts.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41092">%TRUE if the mount point is a loopback. %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41088">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_readonly" c:identifier="g_unix_mount_point_is_readonly">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41096">Checks if a unix mount point is read only.</doc>
|
|
<source-position filename="gunixmounts.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41102">%TRUE if a mount point is read only.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41098">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_user_mountable" c:identifier="g_unix_mount_point_is_user_mountable">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41106">Checks if a unix mount point is mountable by the user.</doc>
|
|
<source-position filename="gunixmounts.h" line="120"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41112">%TRUE if the mount point is user mountable.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="mount_point" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41108">a #GUnixMountPoint.</doc>
|
|
<type name="UnixMountPoint" c:type="GUnixMountPoint*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
</record>
|
|
<class name="UnixOutputStream" c:symbol-prefix="unix_output_stream" c:type="GUnixOutputStream" parent="OutputStream" glib:type-name="GUnixOutputStream" glib:get-type="g_unix_output_stream_get_type" glib:type-struct="UnixOutputStreamClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9666">#GUnixOutputStream implements #GOutputStream for writing to a UNIX
|
|
file descriptor, including asynchronous operations. (If the file
|
|
descriptor refers to a socket or pipe, this will use poll() to do
|
|
asynchronous I/O. If it refers to a regular file, it will fall back
|
|
to doing asynchronous I/O in another thread.)
|
|
|
|
Note that `<gio/gunixoutputstream.h>` belongs to the UNIX-specific GIO
|
|
interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file
|
|
when using it.</doc>
|
|
<source-position filename="gunixoutputstream.h" line="65"/>
|
|
<implements name="FileDescriptorBased"/>
|
|
<implements name="PollableOutputStream"/>
|
|
<constructor name="new" c:identifier="g_unix_output_stream_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41187">Creates a new #GUnixOutputStream for the given @fd.
|
|
|
|
If @close_fd, is %TRUE, the file descriptor will be closed when
|
|
the output stream is destroyed.</doc>
|
|
<source-position filename="gunixoutputstream.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41197">a new #GOutputStream</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41189">a UNIX file descriptor</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="close_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41190">%TRUE to close the file descriptor when done</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_close_fd" c:identifier="g_unix_output_stream_get_close_fd" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41164">Returns whether the file descriptor of @stream will be
|
|
closed when the stream is closed.</doc>
|
|
<source-position filename="gunixoutputstream.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41171">%TRUE if the file descriptor is closed when done</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41166">a #GUnixOutputStream</doc>
|
|
<type name="UnixOutputStream" c:type="GUnixOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_fd" c:identifier="g_unix_output_stream_get_fd" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41176">Return the UNIX file descriptor that the stream writes to.</doc>
|
|
<source-position filename="gunixoutputstream.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41182">The file descriptor of @stream</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41178">a #GUnixOutputStream</doc>
|
|
<type name="UnixOutputStream" c:type="GUnixOutputStream*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_close_fd" c:identifier="g_unix_output_stream_set_close_fd" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41201">Sets whether the file descriptor of @stream shall be closed
|
|
when the stream is closed.</doc>
|
|
<source-position filename="gunixoutputstream.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41203">a #GUnixOutputStream</doc>
|
|
<type name="UnixOutputStream" c:type="GUnixOutputStream*"/>
|
|
</instance-parameter>
|
|
<parameter name="close_fd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41204">%TRUE to close the file descriptor when done</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="close-fd" version="2.20" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4113">Whether to close the file descriptor when the stream is closed.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="fd" version="2.20" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4122">The file descriptor that the stream writes to.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="OutputStream" c:type="GOutputStream"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="UnixOutputStreamPrivate" c:type="GUnixOutputStreamPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="UnixOutputStreamClass" c:type="GUnixOutputStreamClass" glib:is-gtype-struct-for="UnixOutputStream">
|
|
<source-position filename="gunixoutputstream.h" line="65"/>
|
|
<field name="parent_class">
|
|
<type name="OutputStreamClass" c:type="GOutputStreamClass"/>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gunixoutputstream.h" line="60"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gunixoutputstream.h" line="61"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gunixoutputstream.h" line="62"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gunixoutputstream.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gunixoutputstream.h" line="64"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<record name="UnixOutputStreamPrivate" c:type="GUnixOutputStreamPrivate" disguised="1">
|
|
<source-position filename="gunixoutputstream.h" line="42"/>
|
|
</record>
|
|
<class name="UnixSocketAddress" c:symbol-prefix="unix_socket_address" c:type="GUnixSocketAddress" parent="SocketAddress" glib:type-name="GUnixSocketAddress" glib:get-type="g_unix_socket_address_get_type" glib:type-struct="UnixSocketAddressClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9684">Support for UNIX-domain (also known as local) sockets.
|
|
|
|
UNIX domain sockets are generally visible in the filesystem.
|
|
However, some systems support abstract socket names which are not
|
|
visible in the filesystem and not affected by the filesystem
|
|
permissions, visibility, etc. Currently this is only supported
|
|
under Linux. If you attempt to use abstract sockets on other
|
|
systems, function calls may return %G_IO_ERROR_NOT_SUPPORTED
|
|
errors. You can use g_unix_socket_address_abstract_names_supported()
|
|
to see if abstract names are supported.
|
|
|
|
Note that `<gio/gunixsocketaddress.h>` belongs to the UNIX-specific GIO
|
|
interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file
|
|
when using it.</doc>
|
|
<source-position filename="gunixsocketaddress.h" line="53"/>
|
|
<implements name="SocketConnectable"/>
|
|
<constructor name="new" c:identifier="g_unix_socket_address_new" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41275">Creates a new #GUnixSocketAddress for @path.
|
|
|
|
To create abstract socket addresses, on systems that support that,
|
|
use g_unix_socket_address_new_abstract().</doc>
|
|
<source-position filename="gunixsocketaddress.h" line="59"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41284">a new #GUnixSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41277">the socket path</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_abstract" c:identifier="g_unix_socket_address_new_abstract" deprecated="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41289">Creates a new %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED
|
|
#GUnixSocketAddress for @path.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_unix_socket_address_new_with_type().</doc-deprecated>
|
|
<source-position filename="gunixsocketaddress.h" line="61"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41297">a new #GUnixSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41291">the abstract name</doc>
|
|
<array length="1" zero-terminated="0" c:type="const gchar*">
|
|
<type name="gchar"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="path_len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41292">the length of @path, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<constructor name="new_with_type" c:identifier="g_unix_socket_address_new_with_type" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41302">Creates a new #GUnixSocketAddress of type @type with name @path.
|
|
|
|
If @type is %G_UNIX_SOCKET_ADDRESS_PATH, this is equivalent to
|
|
calling g_unix_socket_address_new().
|
|
|
|
If @type is %G_UNIX_SOCKET_ADDRESS_ANONYMOUS, @path and @path_len will be
|
|
ignored.
|
|
|
|
If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT, then @path_len
|
|
bytes of @path will be copied to the socket's path, and only those
|
|
bytes will be considered part of the name. (If @path_len is -1,
|
|
then @path is assumed to be NUL-terminated.) For example, if @path
|
|
was "test", then calling g_socket_address_get_native_size() on the
|
|
returned socket would return 7 (2 bytes of overhead, 1 byte for the
|
|
abstract-socket indicator byte, and 4 bytes for the name "test").
|
|
|
|
If @path_type is %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED, then
|
|
@path_len bytes of @path will be copied to the socket's path, the
|
|
rest of the path will be padded with 0 bytes, and the entire
|
|
zero-padded buffer will be considered the name. (As above, if
|
|
@path_len is -1, then @path is assumed to be NUL-terminated.) In
|
|
this case, g_socket_address_get_native_size() will always return
|
|
the full size of a `struct sockaddr_un`, although
|
|
g_unix_socket_address_get_path_len() will still return just the
|
|
length of @path.
|
|
|
|
%G_UNIX_SOCKET_ADDRESS_ABSTRACT is preferred over
|
|
%G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED for new programs. Of course,
|
|
when connecting to a server created by another process, you must
|
|
use the appropriate type corresponding to how that process created
|
|
its listening socket.</doc>
|
|
<source-position filename="gunixsocketaddress.h" line="64"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41340">a new #GUnixSocketAddress</doc>
|
|
<type name="SocketAddress" c:type="GSocketAddress*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41304">the name</doc>
|
|
<array length="1" zero-terminated="0" c:type="const gchar*">
|
|
<type name="gchar"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="path_len" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41305">the length of @path, or -1</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41306">a #GUnixSocketAddressType</doc>
|
|
<type name="UnixSocketAddressType" c:type="GUnixSocketAddressType"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<function name="abstract_names_supported" c:identifier="g_unix_socket_address_abstract_names_supported" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41213">Checks if abstract UNIX domain socket names are supported.</doc>
|
|
<source-position filename="gunixsocketaddress.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41218">%TRUE if supported, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
</function>
|
|
<method name="get_address_type" c:identifier="g_unix_socket_address_get_address_type" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41223">Gets @address's type.</doc>
|
|
<source-position filename="gunixsocketaddress.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41229">a #GUnixSocketAddressType</doc>
|
|
<type name="UnixSocketAddressType" c:type="GUnixSocketAddressType"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41225">a #GInetSocketAddress</doc>
|
|
<type name="UnixSocketAddress" c:type="GUnixSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_is_abstract" c:identifier="g_unix_socket_address_get_is_abstract" version="2.22" deprecated="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41234">Tests if @address is abstract.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_unix_socket_address_get_address_type()</doc-deprecated>
|
|
<source-position filename="gunixsocketaddress.h" line="74"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41240">%TRUE if the address is abstract, %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41236">a #GInetSocketAddress</doc>
|
|
<type name="UnixSocketAddress" c:type="GUnixSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_path" c:identifier="g_unix_socket_address_get_path" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41246">Gets @address's path, or for abstract sockets the "name".
|
|
|
|
Guaranteed to be zero-terminated, but an abstract socket
|
|
may contain embedded zeros, and thus you should use
|
|
g_unix_socket_address_get_path_len() to get the true length
|
|
of this string.</doc>
|
|
<source-position filename="gunixsocketaddress.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41257">the path for @address</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41248">a #GInetSocketAddress</doc>
|
|
<type name="UnixSocketAddress" c:type="GUnixSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_path_len" c:identifier="g_unix_socket_address_get_path_len" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41262">Gets the length of @address's path.
|
|
|
|
For details, see g_unix_socket_address_get_path().</doc>
|
|
<source-position filename="gunixsocketaddress.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41270">the length of the path</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41264">a #GInetSocketAddress</doc>
|
|
<type name="UnixSocketAddress" c:type="GUnixSocketAddress*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="abstract" deprecated="1" writable="1" construct-only="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4139">Whether or not this is an abstract address</doc>
|
|
<doc-deprecated xml:space="preserve">Use #GUnixSocketAddress:address-type, which
|
|
distinguishes between zero-padded and non-zero-padded
|
|
abstract addresses.</doc-deprecated>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</property>
|
|
<property name="address-type" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="UnixSocketAddressType"/>
|
|
</property>
|
|
<property name="path" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</property>
|
|
<property name="path-as-array" writable="1" construct-only="1" transfer-ownership="none">
|
|
<array name="GLib.ByteArray">
|
|
<type name="guint8" c:type="guint8"/>
|
|
</array>
|
|
</property>
|
|
<field name="parent_instance">
|
|
<type name="SocketAddress" c:type="GSocketAddress"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="UnixSocketAddressPrivate" c:type="GUnixSocketAddressPrivate*"/>
|
|
</field>
|
|
</class>
|
|
<record name="UnixSocketAddressClass" c:type="GUnixSocketAddressClass" glib:is-gtype-struct-for="UnixSocketAddress">
|
|
<source-position filename="gunixsocketaddress.h" line="53"/>
|
|
<field name="parent_class">
|
|
<type name="SocketAddressClass" c:type="GSocketAddressClass"/>
|
|
</field>
|
|
</record>
|
|
<record name="UnixSocketAddressPrivate" c:type="GUnixSocketAddressPrivate" disguised="1">
|
|
<source-position filename="gunixsocketaddress.h" line="38"/>
|
|
</record>
|
|
<enumeration name="UnixSocketAddressType" version="2.26" glib:type-name="GUnixSocketAddressType" glib:get-type="g_unix_socket_address_type_get_type" c:type="GUnixSocketAddressType">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="917">The type of name used by a #GUnixSocketAddress.
|
|
%G_UNIX_SOCKET_ADDRESS_PATH indicates a traditional unix domain
|
|
socket bound to a filesystem path. %G_UNIX_SOCKET_ADDRESS_ANONYMOUS
|
|
indicates a socket not bound to any name (eg, a client-side socket,
|
|
or a socket created with socketpair()).
|
|
|
|
For abstract sockets, there are two incompatible ways of naming
|
|
them; the man pages suggest using the entire `struct sockaddr_un`
|
|
as the name, padding the unused parts of the %sun_path field with
|
|
zeroes; this corresponds to %G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED.
|
|
However, many programs instead just use a portion of %sun_path, and
|
|
pass an appropriate smaller length to bind() or connect(). This is
|
|
%G_UNIX_SOCKET_ADDRESS_ABSTRACT.</doc>
|
|
<member name="invalid" value="0" c:identifier="G_UNIX_SOCKET_ADDRESS_INVALID" glib:nick="invalid">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="919">invalid</doc>
|
|
</member>
|
|
<member name="anonymous" value="1" c:identifier="G_UNIX_SOCKET_ADDRESS_ANONYMOUS" glib:nick="anonymous">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="920">anonymous</doc>
|
|
</member>
|
|
<member name="path" value="2" c:identifier="G_UNIX_SOCKET_ADDRESS_PATH" glib:nick="path">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="921">a filesystem path</doc>
|
|
</member>
|
|
<member name="abstract" value="3" c:identifier="G_UNIX_SOCKET_ADDRESS_ABSTRACT" glib:nick="abstract">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="922">an abstract name</doc>
|
|
</member>
|
|
<member name="abstract_padded" value="4" c:identifier="G_UNIX_SOCKET_ADDRESS_ABSTRACT_PADDED" glib:nick="abstract-padded">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="923">an abstract name, 0-padded
|
|
to the full length of a unix socket name</doc>
|
|
</member>
|
|
</enumeration>
|
|
<function-macro name="VFS" c:identifier="G_VFS" introspectable="0">
|
|
<source-position filename="gvfs.h" line="33"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="VFS_CLASS" c:identifier="G_VFS_CLASS" introspectable="0">
|
|
<source-position filename="gvfs.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="VFS_EXTENSION_POINT_NAME" value="gio-vfs" c:type="G_VFS_EXTENSION_POINT_NAME">
|
|
<doc xml:space="preserve" filename="gvfs.h" line="61">Extension point for #GVfs functionality.
|
|
See [Extending GIO][extending-gio].</doc>
|
|
<source-position filename="gvfs.h" line="67"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="VFS_GET_CLASS" c:identifier="G_VFS_GET_CLASS" introspectable="0">
|
|
<source-position filename="gvfs.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="VOLUME" c:identifier="G_VOLUME" introspectable="0">
|
|
<source-position filename="gvolume.h" line="87"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="VOLUME_GET_IFACE" c:identifier="G_VOLUME_GET_IFACE" introspectable="0">
|
|
<source-position filename="gvolume.h" line="89"/>
|
|
<parameters>
|
|
<parameter name="obj">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="VOLUME_IDENTIFIER_KIND_CLASS" value="class" c:type="G_VOLUME_IDENTIFIER_KIND_CLASS">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="70">The string used to obtain the volume class with g_volume_get_identifier().
|
|
|
|
Known volume classes include `device`, `network`, and `loop`. Other
|
|
classes may be added in the future.
|
|
|
|
This is intended to be used by applications to classify #GVolume
|
|
instances into different sections - for example a file manager or
|
|
file chooser can use this information to show `network` volumes under
|
|
a "Network" heading and `device` volumes under a "Devices" heading.</doc>
|
|
<source-position filename="gvolume.h" line="83"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="VOLUME_IDENTIFIER_KIND_HAL_UDI" value="hal-udi" c:type="G_VOLUME_IDENTIFIER_KIND_HAL_UDI" deprecated="1" deprecated-version="2.58">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="33">The string used to obtain a Hal UDI with g_volume_get_identifier().</doc>
|
|
<doc-deprecated xml:space="preserve">Do not use, HAL is deprecated.</doc-deprecated>
|
|
<source-position filename="gvolume.h" line="40"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="VOLUME_IDENTIFIER_KIND_LABEL" value="label" c:type="G_VOLUME_IDENTIFIER_KIND_LABEL">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="49">The string used to obtain a filesystem label with g_volume_get_identifier().</doc>
|
|
<source-position filename="gvolume.h" line="54"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="VOLUME_IDENTIFIER_KIND_NFS_MOUNT" value="nfs-mount" c:type="G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="63">The string used to obtain a NFS mount with g_volume_get_identifier().</doc>
|
|
<source-position filename="gvolume.h" line="68"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="VOLUME_IDENTIFIER_KIND_UNIX_DEVICE" value="unix-device" c:type="G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="42">The string used to obtain a Unix device path with g_volume_get_identifier().</doc>
|
|
<source-position filename="gvolume.h" line="47"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<constant name="VOLUME_IDENTIFIER_KIND_UUID" value="uuid" c:type="G_VOLUME_IDENTIFIER_KIND_UUID">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="56">The string used to obtain a UUID with g_volume_get_identifier().</doc>
|
|
<source-position filename="gvolume.h" line="61"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="VOLUME_MONITOR" c:identifier="G_VOLUME_MONITOR" introspectable="0">
|
|
<source-position filename="gvolumemonitor.h" line="36"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="VOLUME_MONITOR_CLASS" c:identifier="G_VOLUME_MONITOR_CLASS" introspectable="0">
|
|
<source-position filename="gvolumemonitor.h" line="37"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<constant name="VOLUME_MONITOR_EXTENSION_POINT_NAME" value="gio-volume-monitor" c:type="G_VOLUME_MONITOR_EXTENSION_POINT_NAME">
|
|
<doc xml:space="preserve" filename="gvolumemonitor.h" line="42">Extension point for volume monitor functionality.
|
|
See [Extending GIO][extending-gio].</doc>
|
|
<source-position filename="gvolumemonitor.h" line="48"/>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</constant>
|
|
<function-macro name="VOLUME_MONITOR_GET_CLASS" c:identifier="G_VOLUME_MONITOR_GET_CLASS" introspectable="0">
|
|
<source-position filename="gvolumemonitor.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="Vfs" c:symbol-prefix="vfs" c:type="GVfs" parent="GObject.Object" glib:type-name="GVfs" glib:get-type="g_vfs_get_type" glib:type-struct="VfsClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9706">Entry point for using GIO functionality.</doc>
|
|
<source-position filename="gvfs.h" line="127"/>
|
|
<function name="get_default" c:identifier="g_vfs_get_default">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41345">Gets the default #GVfs for the system.</doc>
|
|
<source-position filename="gvfs.h" line="148"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41350">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="get_local" c:identifier="g_vfs_get_local">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41382">Gets the local #GVfs for the system.</doc>
|
|
<source-position filename="gvfs.h" line="150"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41387">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="add_writable_namespaces">
|
|
<source-position filename="gvfs.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="list" transfer-ownership="none">
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="deserialize_icon" introspectable="0">
|
|
<source-position filename="gvfs.h" line="118"/>
|
|
<return-value>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_file_for_path" invoker="get_file_for_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41354">Gets a #GFile for @path.</doc>
|
|
<source-position filename="gvfs.h" line="88"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41361">a #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41356">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41357">a string containing a VFS path.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_file_for_uri" invoker="get_file_for_uri">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41366">Gets a #GFile for @uri.
|
|
|
|
This operation never fails, but the returned object
|
|
might not support any I/O operation if the URI
|
|
is malformed or if the URI scheme is not supported.</doc>
|
|
<source-position filename="gvfs.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41377">a #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41368">a#GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41369">a string containing a URI</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_supported_uri_schemes" invoker="get_supported_uri_schemes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41391">Gets a list of URI schemes supported by @vfs.</doc>
|
|
<source-position filename="gvfs.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41397">a %NULL-terminated array of strings.
|
|
The returned array belongs to GIO and must
|
|
not be freed or modified.</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41393">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="is_active" invoker="is_active">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41403">Checks if the VFS is active.</doc>
|
|
<source-position filename="gvfs.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41409">%TRUE if construction of the @vfs was successful
|
|
and it is now active.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41405">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="local_file_add_info">
|
|
<source-position filename="gvfs.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="device" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="attribute_matcher" transfer-ownership="none">
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="extra_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer*"/>
|
|
</parameter>
|
|
<parameter name="free_extra_data" transfer-ownership="none" scope="async">
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="local_file_moved">
|
|
<source-position filename="gvfs.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="dest" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="local_file_removed">
|
|
<source-position filename="gvfs.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="local_file_set_attributes" throws="1">
|
|
<source-position filename="gvfs.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="parse_name" invoker="parse_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41414">This operation never fails, but the returned object might
|
|
not support any I/O operations if the @parse_name cannot
|
|
be parsed by the #GVfs module.</doc>
|
|
<source-position filename="gvfs.h" line="93"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41423">a #GFile for the given @parse_name.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41416">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="parse_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41417">a string to be parsed by the VFS module.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_file_for_path" c:identifier="g_vfs_get_file_for_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41354">Gets a #GFile for @path.</doc>
|
|
<source-position filename="gvfs.h" line="135"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41361">a #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41356">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41357">a string containing a VFS path.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_file_for_uri" c:identifier="g_vfs_get_file_for_uri">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41366">Gets a #GFile for @uri.
|
|
|
|
This operation never fails, but the returned object
|
|
might not support any I/O operation if the URI
|
|
is malformed or if the URI scheme is not supported.</doc>
|
|
<source-position filename="gvfs.h" line="138"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41377">a #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41368">a#GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41369">a string containing a URI</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_supported_uri_schemes" c:identifier="g_vfs_get_supported_uri_schemes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41391">Gets a list of URI schemes supported by @vfs.</doc>
|
|
<source-position filename="gvfs.h" line="141"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41397">a %NULL-terminated array of strings.
|
|
The returned array belongs to GIO and must
|
|
not be freed or modified.</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41393">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="is_active" c:identifier="g_vfs_is_active">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41403">Checks if the VFS is active.</doc>
|
|
<source-position filename="gvfs.h" line="133"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41409">%TRUE if construction of the @vfs was successful
|
|
and it is now active.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41405">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="parse_name" c:identifier="g_vfs_parse_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41414">This operation never fails, but the returned object might
|
|
not support any I/O operations if the @parse_name cannot
|
|
be parsed by the #GVfs module.</doc>
|
|
<source-position filename="gvfs.h" line="144"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41423">a #GFile for the given @parse_name.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41416">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="parse_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41417">a string to be parsed by the VFS module.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="register_uri_scheme" c:identifier="g_vfs_register_uri_scheme" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41428">Registers @uri_func and @parse_name_func as the #GFile URI and parse name
|
|
lookup functions for URIs with a scheme matching @scheme.
|
|
Note that @scheme is registered only within the running application, as
|
|
opposed to desktop-wide as it happens with GVfs backends.
|
|
|
|
When a #GFile is requested with an URI containing @scheme (e.g. through
|
|
g_file_new_for_uri()), @uri_func will be called to allow a custom
|
|
constructor. The implementation of @uri_func should not be blocking, and
|
|
must not call g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme().
|
|
|
|
When g_file_parse_name() is called with a parse name obtained from such file,
|
|
@parse_name_func will be called to allow the #GFile to be created again. In
|
|
that case, it's responsibility of @parse_name_func to make sure the parse
|
|
name matches what the custom #GFile implementation returned when
|
|
g_file_get_parse_name() was previously called. The implementation of
|
|
@parse_name_func should not be blocking, and must not call
|
|
g_vfs_register_uri_scheme() or g_vfs_unregister_uri_scheme().
|
|
|
|
It's an error to call this function twice with the same scheme. To unregister
|
|
a custom URI scheme, use g_vfs_unregister_uri_scheme().</doc>
|
|
<source-position filename="gvfs.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41465">%TRUE if @scheme was successfully registered, or %FALSE if a handler
|
|
for @scheme already exists.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41430">a #GVfs</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41431">an URI scheme, e.g. "http"</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="uri_func" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="2" destroy="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41432">a #GVfsFileLookupFunc</doc>
|
|
<type name="VfsFileLookupFunc" c:type="GVfsFileLookupFunc"/>
|
|
</parameter>
|
|
<parameter name="uri_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41433">custom data passed to be passed to @uri_func, or %NULL</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="uri_destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41434">function to be called when unregistering the
|
|
URI scheme, or when @vfs is disposed, to free the resources used
|
|
by the URI lookup function</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
<parameter name="parse_name_func" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41437">a #GVfsFileLookupFunc</doc>
|
|
<type name="VfsFileLookupFunc" c:type="GVfsFileLookupFunc"/>
|
|
</parameter>
|
|
<parameter name="parse_name_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41438">custom data passed to be passed to
|
|
@parse_name_func, or %NULL</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="parse_name_destroy" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41440">function to be called when unregistering the
|
|
URI scheme, or when @vfs is disposed, to free the resources used
|
|
by the parse name lookup function</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="unregister_uri_scheme" c:identifier="g_vfs_unregister_uri_scheme" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41471">Unregisters the URI handler for @scheme previously registered with
|
|
g_vfs_register_uri_scheme().</doc>
|
|
<source-position filename="gvfs.h" line="162"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41479">%TRUE if @scheme was successfully unregistered, or %FALSE if a
|
|
handler for @scheme does not exist.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41473">a #GVfs</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</instance-parameter>
|
|
<parameter name="scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41474">an URI scheme, e.g. "http"</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
</class>
|
|
<record name="VfsClass" c:type="GVfsClass" glib:is-gtype-struct-for="Vfs">
|
|
<source-position filename="gvfs.h" line="127"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="is_active">
|
|
<callback name="is_active">
|
|
<source-position filename="gvfs.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41409">%TRUE if construction of the @vfs was successful
|
|
and it is now active.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41405">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_file_for_path">
|
|
<callback name="get_file_for_path">
|
|
<source-position filename="gvfs.h" line="88"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41361">a #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41356">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41357">a string containing a VFS path.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_file_for_uri">
|
|
<callback name="get_file_for_uri">
|
|
<source-position filename="gvfs.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41377">a #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41368">a#GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41369">a string containing a URI</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_supported_uri_schemes">
|
|
<callback name="get_supported_uri_schemes">
|
|
<source-position filename="gvfs.h" line="92"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41397">a %NULL-terminated array of strings.
|
|
The returned array belongs to GIO and must
|
|
not be freed or modified.</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41393">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="parse_name">
|
|
<callback name="parse_name">
|
|
<source-position filename="gvfs.h" line="93"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41423">a #GFile for the given @parse_name.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41416">a #GVfs.</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="parse_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41417">a string to be parsed by the VFS module.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="local_file_add_info">
|
|
<callback name="local_file_add_info">
|
|
<source-position filename="gvfs.h" line="97"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="device" transfer-ownership="none">
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
<parameter name="attribute_matcher" transfer-ownership="none">
|
|
<type name="FileAttributeMatcher" c:type="GFileAttributeMatcher*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="extra_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="gpointer" c:type="gpointer*"/>
|
|
</parameter>
|
|
<parameter name="free_extra_data" transfer-ownership="none" scope="async">
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="add_writable_namespaces">
|
|
<callback name="add_writable_namespaces">
|
|
<source-position filename="gvfs.h" line="105"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="list" transfer-ownership="none">
|
|
<type name="FileAttributeInfoList" c:type="GFileAttributeInfoList*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="local_file_set_attributes">
|
|
<callback name="local_file_set_attributes" throws="1">
|
|
<source-position filename="gvfs.h" line="107"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="info" transfer-ownership="none">
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<type name="FileQueryInfoFlags" c:type="GFileQueryInfoFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="local_file_removed">
|
|
<callback name="local_file_removed">
|
|
<source-position filename="gvfs.h" line="113"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="local_file_moved">
|
|
<callback name="local_file_moved">
|
|
<source-position filename="gvfs.h" line="115"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="source" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="dest" transfer-ownership="none">
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="deserialize_icon" introspectable="0">
|
|
<callback name="deserialize_icon" introspectable="0">
|
|
<source-position filename="gvfs.h" line="118"/>
|
|
<return-value>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gvfs.h" line="121"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gvfs.h" line="122"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gvfs.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gvfs.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gvfs.h" line="125"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gvfs.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<callback name="VfsFileLookupFunc" c:type="GVfsFileLookupFunc" version="2.50">
|
|
<doc xml:space="preserve" filename="gvfs.h" line="39">This function type is used by g_vfs_register_uri_scheme() to make it
|
|
possible for a client to associate an URI scheme to a different #GFile
|
|
implementation.
|
|
|
|
The client should return a reference to the new file that has been
|
|
created for @uri, or %NULL to continue with the default implementation.</doc>
|
|
<source-position filename="gvfs.h" line="57"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gvfs.h" line="53">a #GFile for @identifier.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="vfs" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gvfs.h" line="41">a #GVfs</doc>
|
|
<type name="Vfs" c:type="GVfs*"/>
|
|
</parameter>
|
|
<parameter name="identifier" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gvfs.h" line="42">the identifier to look up a #GFile for. This can either
|
|
be an URI or a parse name as returned by g_file_get_parse_name()</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="2">
|
|
<doc xml:space="preserve" filename="gvfs.h" line="44">user data passed to the function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
<interface name="Volume" c:symbol-prefix="volume" c:type="GVolume" glib:type-name="GVolume" glib:get-type="g_volume_get_type" glib:type-struct="VolumeIface">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9715">The #GVolume interface represents user-visible objects that can be
|
|
mounted. Note, when porting from GnomeVFS, #GVolume is the moral
|
|
equivalent of #GnomeVFSDrive.
|
|
|
|
Mounting a #GVolume instance is an asynchronous operation. For more
|
|
information about asynchronous operations, see #GAsyncResult and
|
|
#GTask. To mount a #GVolume, first call g_volume_mount() with (at
|
|
least) the #GVolume instance, optionally a #GMountOperation object
|
|
and a #GAsyncReadyCallback.
|
|
|
|
Typically, one will only want to pass %NULL for the
|
|
#GMountOperation if automounting all volumes when a desktop session
|
|
starts since it's not desirable to put up a lot of dialogs asking
|
|
for credentials.
|
|
|
|
The callback will be fired when the operation has resolved (either
|
|
with success or failure), and a #GAsyncResult instance will be
|
|
passed to the callback. That callback should then call
|
|
g_volume_mount_finish() with the #GVolume instance and the
|
|
#GAsyncResult data to see if the operation was completed
|
|
successfully. If an @error is present when g_volume_mount_finish()
|
|
is called, then it will be filled with any error information.
|
|
|
|
## Volume Identifiers # {#volume-identifier}
|
|
|
|
It is sometimes necessary to directly access the underlying
|
|
operating system object behind a volume (e.g. for passing a volume
|
|
to an application via the commandline). For this purpose, GIO
|
|
allows to obtain an 'identifier' for the volume. There can be
|
|
different kinds of identifiers, such as Hal UDIs, filesystem labels,
|
|
traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined
|
|
strings as names for the different kinds of identifiers:
|
|
#G_VOLUME_IDENTIFIER_KIND_UUID, #G_VOLUME_IDENTIFIER_KIND_LABEL, etc.
|
|
Use g_volume_get_identifier() to obtain an identifier for a volume.
|
|
|
|
|
|
Note that #G_VOLUME_IDENTIFIER_KIND_HAL_UDI will only be available
|
|
when the gvfs hal volume monitor is in use. Other volume monitors
|
|
will generally be able to provide the #G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE
|
|
identifier, which can be used to obtain a hal device by means of
|
|
libhal_manager_find_device_string_match().</doc>
|
|
<source-position filename="gvolume.h" line="182"/>
|
|
<virtual-method name="can_eject" invoker="can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41485">Checks if a volume can be ejected.</doc>
|
|
<source-position filename="gvolume.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41491">%TRUE if the @volume can be ejected. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41487">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="can_mount" invoker="can_mount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41495">Checks if a volume can be mounted.</doc>
|
|
<source-position filename="gvolume.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41501">%TRUE if the @volume can be mounted. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41497">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="changed">
|
|
<source-position filename="gvolume.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject" invoker="eject" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41505">Ejects a volume. This is an asynchronous operation, and is
|
|
finished by calling g_volume_eject_finish() with the @volume
|
|
and #GAsyncResult returned in the @callback.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_volume_eject_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gvolume.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41507">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41508">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41509">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41510">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41511">user data that gets passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_finish" invoker="eject_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41521">Finishes ejecting a volume. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_volume_eject_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gvolume.h" line="158"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41530">%TRUE, %FALSE if operation failed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41523">pointer to a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41524">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_with_operation" invoker="eject_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41535">Ejects a volume. This is an asynchronous operation, and is
|
|
finished by calling g_volume_eject_with_operation_finish() with the @volume
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gvolume.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41537">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41538">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41539">a #GMountOperation or %NULL to
|
|
avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41541">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41542">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41543">user data passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="eject_with_operation_finish" invoker="eject_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41553">Finishes ejecting a volume. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gvolume.h" line="176"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41562">%TRUE if the volume was successfully ejected. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41555">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41556">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="enumerate_identifiers" invoker="enumerate_identifiers">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41567">Gets the kinds of [identifiers][volume-identifier] that @volume has.
|
|
Use g_volume_get_identifier() to obtain the identifiers themselves.</doc>
|
|
<source-position filename="gvolume.h" line="164"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41574">a %NULL-terminated array
|
|
of strings containing kinds of identifiers. Use g_strfreev() to free.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41569">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_activation_root" invoker="get_activation_root" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41579">Gets the activation root for a #GVolume if it is known ahead of
|
|
mount time. Returns %NULL otherwise. If not %NULL and if @volume
|
|
is mounted, then the result of g_mount_get_root() on the
|
|
#GMount object obtained from g_volume_get_mount() will always
|
|
either be equal or a prefix of what this function returns. In
|
|
other words, in code
|
|
|
|
|[<!-- language="C" -->
|
|
GMount *mount;
|
|
GFile *mount_root
|
|
GFile *volume_activation_root;
|
|
|
|
mount = g_volume_get_mount (volume); // mounted, so never NULL
|
|
mount_root = g_mount_get_root (mount);
|
|
volume_activation_root = g_volume_get_activation_root (volume); // assume not NULL
|
|
]|
|
|
then the expression
|
|
|[<!-- language="C" -->
|
|
(g_file_has_prefix (volume_activation_root, mount_root) ||
|
|
g_file_equal (volume_activation_root, mount_root))
|
|
]|
|
|
will always be %TRUE.
|
|
|
|
Activation roots are typically used in #GVolumeMonitor
|
|
implementations to find the underlying mount to shadow, see
|
|
g_mount_is_shadowed() for more details.</doc>
|
|
<source-position filename="gvolume.h" line="168"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41610">the activation root of @volume
|
|
or %NULL. Use g_object_unref() to free.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41581">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_drive" invoker="get_drive">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41616">Gets the drive for the @volume.</doc>
|
|
<source-position filename="gvolume.h" line="140"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41622">a #GDrive or %NULL if @volume is not
|
|
associated with a drive. The returned object should be unreffed
|
|
with g_object_unref() when no longer needed.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41618">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_icon" invoker="get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41628">Gets the icon for @volume.</doc>
|
|
<source-position filename="gvolume.h" line="138"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41634">a #GIcon.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41630">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_identifier" invoker="get_identifier">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41640">Gets the identifier of the given kind for @volume.
|
|
See the [introduction][volume-identifier] for more
|
|
information about volume identifiers.</doc>
|
|
<source-position filename="gvolume.h" line="162"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41649">a newly allocated string containing the
|
|
requested identifier, or %NULL if the #GVolume
|
|
doesn't have this kind of identifier</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41642">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="kind" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41643">the kind of identifier to return</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_mount" invoker="get_mount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41655">Gets the mount for the @volume.</doc>
|
|
<source-position filename="gvolume.h" line="141"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41661">a #GMount or %NULL if @volume isn't mounted.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41657">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_name" invoker="get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41667">Gets the name of @volume.</doc>
|
|
<source-position filename="gvolume.h" line="137"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41673">the name for the given @volume. The returned string should
|
|
be freed with g_free() when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41669">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_sort_key" invoker="get_sort_key" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41678">Gets the sort key for @volume, if any.</doc>
|
|
<source-position filename="gvolume.h" line="180"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41684">Sorting key for @volume or %NULL if no such key is available</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41680">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_symbolic_icon" invoker="get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41689">Gets the symbolic icon for @volume.</doc>
|
|
<source-position filename="gvolume.h" line="181"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41695">a #GIcon.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41691">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_uuid" invoker="get_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41702">Gets the UUID for the @volume. The reference is typically based on
|
|
the file system UUID for the volume in question and should be
|
|
considered an opaque string. Returns %NULL if there is no UUID
|
|
available.</doc>
|
|
<source-position filename="gvolume.h" line="139"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41711">the UUID for @volume or %NULL if no UUID
|
|
can be computed.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41704">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_finish" invoker="mount_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41849">Finishes mounting a volume. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.
|
|
|
|
If the mount operation succeeded, g_volume_get_mount() on @volume
|
|
is guaranteed to return the mount right after calling this
|
|
function; there's no need to listen for the 'mount-added' signal on
|
|
#GVolumeMonitor.</doc>
|
|
<source-position filename="gvolume.h" line="150"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41863">%TRUE, %FALSE if operation failed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41851">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41852">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_fn" invoker="mount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41834">Mounts a volume. This is an asynchronous operation, and is
|
|
finished by calling g_volume_mount_finish() with the @volume
|
|
and #GAsyncResult returned in the @callback.</doc>
|
|
<source-position filename="gvolume.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41836">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41837">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41838">a #GMountOperation or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41839">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41840">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41841">user data that gets passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="removed">
|
|
<source-position filename="gvolume.h" line="133"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="should_automount" invoker="should_automount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41867">Returns whether the volume should be automatically mounted.</doc>
|
|
<source-position filename="gvolume.h" line="166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41873">%TRUE if the volume should be automatically mounted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41869">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="can_eject" c:identifier="g_volume_can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41485">Checks if a volume can be ejected.</doc>
|
|
<source-position filename="gvolume.h" line="202"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41491">%TRUE if the @volume can be ejected. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41487">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="can_mount" c:identifier="g_volume_can_mount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41495">Checks if a volume can be mounted.</doc>
|
|
<source-position filename="gvolume.h" line="200"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41501">%TRUE if the @volume can be mounted. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41497">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject" c:identifier="g_volume_eject" deprecated="1" deprecated-version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41505">Ejects a volume. This is an asynchronous operation, and is
|
|
finished by calling g_volume_eject_finish() with the @volume
|
|
and #GAsyncResult returned in the @callback.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_volume_eject_with_operation() instead.</doc-deprecated>
|
|
<source-position filename="gvolume.h" line="217"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41507">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41508">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41509">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41510">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41511">user data that gets passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_finish" c:identifier="g_volume_eject_finish" deprecated="1" deprecated-version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41521">Finishes ejecting a volume. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_volume_eject_with_operation_finish() instead.</doc-deprecated>
|
|
<source-position filename="gvolume.h" line="224"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41530">%TRUE, %FALSE if operation failed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41523">pointer to a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41524">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_with_operation" c:identifier="g_volume_eject_with_operation" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41535">Ejects a volume. This is an asynchronous operation, and is
|
|
finished by calling g_volume_eject_with_operation_finish() with the @volume
|
|
and #GAsyncResult data returned in the @callback.</doc>
|
|
<source-position filename="gvolume.h" line="237"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41537">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41538">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41539">a #GMountOperation or %NULL to
|
|
avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41541">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41542">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41543">user data passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="eject_with_operation_finish" c:identifier="g_volume_eject_with_operation_finish" version="2.22" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41553">Finishes ejecting a volume. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.</doc>
|
|
<source-position filename="gvolume.h" line="244"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41562">%TRUE if the volume was successfully ejected. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41555">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41556">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="enumerate_identifiers" c:identifier="g_volume_enumerate_identifiers">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41567">Gets the kinds of [identifiers][volume-identifier] that @volume has.
|
|
Use g_volume_get_identifier() to obtain the identifiers themselves.</doc>
|
|
<source-position filename="gvolume.h" line="231"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41574">a %NULL-terminated array
|
|
of strings containing kinds of identifiers. Use g_strfreev() to free.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41569">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_activation_root" c:identifier="g_volume_get_activation_root" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41579">Gets the activation root for a #GVolume if it is known ahead of
|
|
mount time. Returns %NULL otherwise. If not %NULL and if @volume
|
|
is mounted, then the result of g_mount_get_root() on the
|
|
#GMount object obtained from g_volume_get_mount() will always
|
|
either be equal or a prefix of what this function returns. In
|
|
other words, in code
|
|
|
|
|[<!-- language="C" -->
|
|
GMount *mount;
|
|
GFile *mount_root
|
|
GFile *volume_activation_root;
|
|
|
|
mount = g_volume_get_mount (volume); // mounted, so never NULL
|
|
mount_root = g_mount_get_root (mount);
|
|
volume_activation_root = g_volume_get_activation_root (volume); // assume not NULL
|
|
]|
|
|
then the expression
|
|
|[<!-- language="C" -->
|
|
(g_file_has_prefix (volume_activation_root, mount_root) ||
|
|
g_file_equal (volume_activation_root, mount_root))
|
|
]|
|
|
will always be %TRUE.
|
|
|
|
Activation roots are typically used in #GVolumeMonitor
|
|
implementations to find the underlying mount to shadow, see
|
|
g_mount_is_shadowed() for more details.</doc>
|
|
<source-position filename="gvolume.h" line="234"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41610">the activation root of @volume
|
|
or %NULL. Use g_object_unref() to free.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41581">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_drive" c:identifier="g_volume_get_drive">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41616">Gets the drive for the @volume.</doc>
|
|
<source-position filename="gvolume.h" line="196"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41622">a #GDrive or %NULL if @volume is not
|
|
associated with a drive. The returned object should be unreffed
|
|
with g_object_unref() when no longer needed.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41618">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_icon" c:identifier="g_volume_get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41628">Gets the icon for @volume.</doc>
|
|
<source-position filename="gvolume.h" line="190"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41634">a #GIcon.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41630">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_identifier" c:identifier="g_volume_get_identifier">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41640">Gets the identifier of the given kind for @volume.
|
|
See the [introduction][volume-identifier] for more
|
|
information about volume identifiers.</doc>
|
|
<source-position filename="gvolume.h" line="228"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41649">a newly allocated string containing the
|
|
requested identifier, or %NULL if the #GVolume
|
|
doesn't have this kind of identifier</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41642">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="kind" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41643">the kind of identifier to return</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_mount" c:identifier="g_volume_get_mount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41655">Gets the mount for the @volume.</doc>
|
|
<source-position filename="gvolume.h" line="198"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41661">a #GMount or %NULL if @volume isn't mounted.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41657">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_name" c:identifier="g_volume_get_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41667">Gets the name of @volume.</doc>
|
|
<source-position filename="gvolume.h" line="188"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41673">the name for the given @volume. The returned string should
|
|
be freed with g_free() when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41669">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_sort_key" c:identifier="g_volume_get_sort_key" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41678">Gets the sort key for @volume, if any.</doc>
|
|
<source-position filename="gvolume.h" line="249"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41684">Sorting key for @volume or %NULL if no such key is available</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41680">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_symbolic_icon" c:identifier="g_volume_get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41689">Gets the symbolic icon for @volume.</doc>
|
|
<source-position filename="gvolume.h" line="192"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41695">a #GIcon.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41691">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_uuid" c:identifier="g_volume_get_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41702">Gets the UUID for the @volume. The reference is typically based on
|
|
the file system UUID for the volume in question and should be
|
|
considered an opaque string. Returns %NULL if there is no UUID
|
|
available.</doc>
|
|
<source-position filename="gvolume.h" line="194"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41711">the UUID for @volume or %NULL if no UUID
|
|
can be computed.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41704">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="mount" c:identifier="g_volume_mount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41834">Mounts a volume. This is an asynchronous operation, and is
|
|
finished by calling g_volume_mount_finish() with the @volume
|
|
and #GAsyncResult returned in the @callback.</doc>
|
|
<source-position filename="gvolume.h" line="206"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41836">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41837">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41838">a #GMountOperation or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41839">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41840">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41841">user data that gets passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="mount_finish" c:identifier="g_volume_mount_finish" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41849">Finishes mounting a volume. If any errors occurred during the operation,
|
|
@error will be set to contain the errors and %FALSE will be returned.
|
|
|
|
If the mount operation succeeded, g_volume_get_mount() on @volume
|
|
is guaranteed to return the mount right after calling this
|
|
function; there's no need to listen for the 'mount-added' signal on
|
|
#GVolumeMonitor.</doc>
|
|
<source-position filename="gvolume.h" line="213"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41863">%TRUE, %FALSE if operation failed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41851">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41852">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="should_automount" c:identifier="g_volume_should_automount">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41867">Returns whether the volume should be automatically mounted.</doc>
|
|
<source-position filename="gvolume.h" line="204"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41873">%TRUE if the volume should be automatically mounted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41869">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<glib:signal name="changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4150">Emitted when the volume has been changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
<glib:signal name="removed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4157">This signal is emitted when the #GVolume have been removed. If
|
|
the recipient is holding references to the object they should
|
|
release them so the object can be finalized.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</glib:signal>
|
|
</interface>
|
|
<record name="VolumeIface" c:type="GVolumeIface" glib:is-gtype-struct-for="Volume">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="91">Interface for implementing operations for mountable volumes.</doc>
|
|
<source-position filename="gvolume.h" line="182"/>
|
|
<field name="g_iface">
|
|
<doc xml:space="preserve" filename="gvolume.h" line="93">The parent interface.</doc>
|
|
<type name="GObject.TypeInterface" c:type="GTypeInterface"/>
|
|
</field>
|
|
<field name="changed">
|
|
<callback name="changed">
|
|
<source-position filename="gvolume.h" line="132"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="removed">
|
|
<callback name="removed">
|
|
<source-position filename="gvolume.h" line="133"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_name">
|
|
<callback name="get_name">
|
|
<source-position filename="gvolume.h" line="137"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41673">the name for the given @volume. The returned string should
|
|
be freed with g_free() when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41669">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_icon">
|
|
<callback name="get_icon">
|
|
<source-position filename="gvolume.h" line="138"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41634">a #GIcon.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41630">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_uuid">
|
|
<callback name="get_uuid">
|
|
<source-position filename="gvolume.h" line="139"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41711">the UUID for @volume or %NULL if no UUID
|
|
can be computed.
|
|
The returned string should be freed with g_free()
|
|
when no longer needed.</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41704">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_drive">
|
|
<callback name="get_drive">
|
|
<source-position filename="gvolume.h" line="140"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41622">a #GDrive or %NULL if @volume is not
|
|
associated with a drive. The returned object should be unreffed
|
|
with g_object_unref() when no longer needed.</doc>
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41618">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_mount">
|
|
<callback name="get_mount">
|
|
<source-position filename="gvolume.h" line="141"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41661">a #GMount or %NULL if @volume isn't mounted.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41657">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_mount">
|
|
<callback name="can_mount">
|
|
<source-position filename="gvolume.h" line="142"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41501">%TRUE if the @volume can be mounted. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41497">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="can_eject">
|
|
<callback name="can_eject">
|
|
<source-position filename="gvolume.h" line="143"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41491">%TRUE if the @volume can be ejected. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41487">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_fn">
|
|
<callback name="mount_fn">
|
|
<source-position filename="gvolume.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41836">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41837">flags affecting the operation</doc>
|
|
<type name="MountMountFlags" c:type="GMountMountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41838">a #GMountOperation or %NULL to avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41839">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41840">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41841">user data that gets passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_finish">
|
|
<callback name="mount_finish" throws="1">
|
|
<source-position filename="gvolume.h" line="150"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41863">%TRUE, %FALSE if operation failed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41851">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41852">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject">
|
|
<callback name="eject">
|
|
<source-position filename="gvolume.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41507">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41508">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41509">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41510">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41511">user data that gets passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_finish">
|
|
<callback name="eject_finish" throws="1">
|
|
<source-position filename="gvolume.h" line="158"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41530">%TRUE, %FALSE if operation failed</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41523">pointer to a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41524">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_identifier">
|
|
<callback name="get_identifier">
|
|
<source-position filename="gvolume.h" line="162"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41649">a newly allocated string containing the
|
|
requested identifier, or %NULL if the #GVolume
|
|
doesn't have this kind of identifier</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41642">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
<parameter name="kind" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41643">the kind of identifier to return</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="enumerate_identifiers">
|
|
<callback name="enumerate_identifiers">
|
|
<source-position filename="gvolume.h" line="164"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41574">a %NULL-terminated array
|
|
of strings containing kinds of identifiers. Use g_strfreev() to free.</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41569">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="should_automount">
|
|
<callback name="should_automount">
|
|
<source-position filename="gvolume.h" line="166"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41873">%TRUE if the volume should be automatically mounted</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41869">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_activation_root">
|
|
<callback name="get_activation_root">
|
|
<source-position filename="gvolume.h" line="168"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41610">the activation root of @volume
|
|
or %NULL. Use g_object_unref() to free.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41581">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_with_operation">
|
|
<callback name="eject_with_operation">
|
|
<source-position filename="gvolume.h" line="170"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41537">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41538">flags affecting the unmount if required for eject</doc>
|
|
<type name="MountUnmountFlags" c:type="GMountUnmountFlags"/>
|
|
</parameter>
|
|
<parameter name="mount_operation" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41539">a #GMountOperation or %NULL to
|
|
avoid user interaction</doc>
|
|
<type name="MountOperation" c:type="GMountOperation*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41541">optional #GCancellable object, %NULL to ignore</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41542">a #GAsyncReadyCallback, or %NULL</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1" closure="5">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41543">user data passed to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="eject_with_operation_finish">
|
|
<callback name="eject_with_operation_finish" throws="1">
|
|
<source-position filename="gvolume.h" line="176"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41562">%TRUE if the volume was successfully ejected. %FALSE otherwise</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41555">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41556">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_sort_key">
|
|
<callback name="get_sort_key">
|
|
<source-position filename="gvolume.h" line="180"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41684">Sorting key for @volume or %NULL if no such key is available</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41680">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_symbolic_icon">
|
|
<callback name="get_symbolic_icon">
|
|
<source-position filename="gvolume.h" line="181"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41695">a #GIcon.
|
|
The returned object should be unreffed with g_object_unref()
|
|
when no longer needed.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41691">a #GVolume</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<class name="VolumeMonitor" c:symbol-prefix="volume_monitor" c:type="GVolumeMonitor" parent="GObject.Object" glib:type-name="GVolumeMonitor" glib:get-type="g_volume_monitor_get_type" glib:type-struct="VolumeMonitorClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="9764">#GVolumeMonitor is for listing the user interesting devices and volumes
|
|
on the computer. In other words, what a file selector or file manager
|
|
would show in a sidebar.
|
|
|
|
#GVolumeMonitor is not
|
|
[thread-default-context aware][g-main-context-push-thread-default],
|
|
and so should not be used other than from the main thread, with no
|
|
thread-default-context active.
|
|
|
|
In order to receive updates about volumes and mounts monitored through GVFS,
|
|
a main loop must be running.</doc>
|
|
<source-position filename="gvolumemonitor.h" line="129"/>
|
|
<function name="adopt_orphan_mount" c:identifier="g_volume_monitor_adopt_orphan_mount" deprecated="1" deprecated-version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41718">This function should be called by any #GVolumeMonitor
|
|
implementation when a new #GMount object is created that is not
|
|
associated with a #GVolume object. It must be called just before
|
|
emitting the @mount_added signal.
|
|
|
|
If the return value is not %NULL, the caller must associate the
|
|
returned #GVolume object with the #GMount. This involves returning
|
|
it in its g_mount_get_volume() implementation. The caller must
|
|
also listen for the "removed" signal on the returned object
|
|
and give up its reference when handling that signal
|
|
|
|
Similarly, if implementing g_volume_monitor_adopt_orphan_mount(),
|
|
the implementor must take a reference to @mount and return it in
|
|
its g_volume_get_mount() implemented. Also, the implementor must
|
|
listen for the "unmounted" signal on @mount and give up its
|
|
reference upon handling that signal.
|
|
|
|
There are two main use cases for this function.
|
|
|
|
One is when implementing a user space file system driver that reads
|
|
blocks of a block device that is already represented by the native
|
|
volume monitor (for example a CD Audio file system driver). Such
|
|
a driver will generate its own #GMount object that needs to be
|
|
associated with the #GVolume object that represents the volume.
|
|
|
|
The other is for implementing a #GVolumeMonitor whose sole purpose
|
|
is to return #GVolume objects representing entries in the users
|
|
"favorite servers" list or similar.</doc>
|
|
<doc-deprecated xml:space="preserve">Instead of using this function, #GVolumeMonitor
|
|
implementations should instead create shadow mounts with the URI of
|
|
the mount they intend to adopt. See the proxy volume monitor in
|
|
gvfs for an example of this. Also see g_mount_is_shadowed(),
|
|
g_mount_shadow() and g_mount_unshadow() functions.</doc-deprecated>
|
|
<source-position filename="gvolumemonitor.h" line="150"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41751">the #GVolume object that is the parent for @mount or %NULL
|
|
if no wants to adopt the #GMount.</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41720">a #GMount object to find a parent for</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="get" c:identifier="g_volume_monitor_get">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41761">Gets the volume monitor used by gio.</doc>
|
|
<source-position filename="gvolumemonitor.h" line="135"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41766">a reference to the #GVolumeMonitor used by gio. Call
|
|
g_object_unref() when done with it.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</return-value>
|
|
</function>
|
|
<virtual-method name="drive_changed">
|
|
<source-position filename="gvolumemonitor.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="drive_connected">
|
|
<source-position filename="gvolumemonitor.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="drive_disconnected">
|
|
<source-position filename="gvolumemonitor.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="drive_eject_button">
|
|
<source-position filename="gvolumemonitor.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="drive_stop_button">
|
|
<source-position filename="gvolumemonitor.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_connected_drives" invoker="get_connected_drives">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41771">Gets a list of drives connected to the system.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gvolumemonitor.h" line="98"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41780">a #GList of connected #GDrive objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Drive"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41773">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_mount_for_uuid" invoker="get_mount_for_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41784">Finds a #GMount object by its UUID (see g_mount_get_uuid())</doc>
|
|
<source-position filename="gvolumemonitor.h" line="105"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41791">a #GMount or %NULL if no such mount is available.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41786">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="uuid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41787">the UUID to look for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_mounts" invoker="get_mounts">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41796">Gets a list of the mounts on the system.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gvolumemonitor.h" line="100"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41805">a #GList of #GMount objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Mount"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41798">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_volume_for_uuid" invoker="get_volume_for_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41809">Finds a #GVolume object by its UUID (see g_volume_get_uuid())</doc>
|
|
<source-position filename="gvolumemonitor.h" line="102"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41816">a #GVolume or %NULL if no such volume is available.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41811">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="uuid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41812">the UUID to look for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="get_volumes" invoker="get_volumes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41821">Gets a list of the volumes on the system.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gvolumemonitor.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41830">a #GList of #GVolume objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Volume"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41823">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_added">
|
|
<source-position filename="gvolumemonitor.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_changed">
|
|
<source-position filename="gvolumemonitor.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_pre_unmount">
|
|
<source-position filename="gvolumemonitor.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="mount_removed">
|
|
<source-position filename="gvolumemonitor.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="volume_added">
|
|
<source-position filename="gvolumemonitor.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="volume_changed">
|
|
<source-position filename="gvolumemonitor.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<virtual-method name="volume_removed">
|
|
<source-position filename="gvolumemonitor.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</virtual-method>
|
|
<method name="get_connected_drives" c:identifier="g_volume_monitor_get_connected_drives">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41771">Gets a list of drives connected to the system.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gvolumemonitor.h" line="137"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41780">a #GList of connected #GDrive objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Drive"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41773">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_mount_for_uuid" c:identifier="g_volume_monitor_get_mount_for_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41784">Finds a #GMount object by its UUID (see g_mount_get_uuid())</doc>
|
|
<source-position filename="gvolumemonitor.h" line="146"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41791">a #GMount or %NULL if no such mount is available.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41786">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="uuid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41787">the UUID to look for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_mounts" c:identifier="g_volume_monitor_get_mounts">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41796">Gets a list of the mounts on the system.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gvolumemonitor.h" line="141"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41805">a #GList of #GMount objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Mount"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41798">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_volume_for_uuid" c:identifier="g_volume_monitor_get_volume_for_uuid">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41809">Finds a #GVolume object by its UUID (see g_volume_get_uuid())</doc>
|
|
<source-position filename="gvolumemonitor.h" line="143"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41816">a #GVolume or %NULL if no such volume is available.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41811">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
<parameter name="uuid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41812">the UUID to look for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="get_volumes" c:identifier="g_volume_monitor_get_volumes">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41821">Gets a list of the volumes on the system.
|
|
|
|
The returned list should be freed with g_list_free(), after
|
|
its elements have been unreffed with g_object_unref().</doc>
|
|
<source-position filename="gvolumemonitor.h" line="139"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41830">a #GList of #GVolume objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Volume"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41823">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<field name="parent_instance">
|
|
<type name="GObject.Object" c:type="GObject"/>
|
|
</field>
|
|
<field name="priv" readable="0" private="1">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</field>
|
|
<glib:signal name="drive-changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4166">Emitted when a drive changes.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4169">the drive that changed</doc>
|
|
<type name="Drive"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="drive-connected" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4175">Emitted when a drive is connected to the system.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4178">a #GDrive that was connected.</doc>
|
|
<type name="Drive"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="drive-disconnected" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4184">Emitted when a drive is disconnected from the system.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4187">a #GDrive that was disconnected.</doc>
|
|
<type name="Drive"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="drive-eject-button" when="last" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4193">Emitted when the eject button is pressed on @drive.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4196">the drive where the eject button was pressed</doc>
|
|
<type name="Drive"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="drive-stop-button" when="last" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4204">Emitted when the stop button is pressed on @drive.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4207">the drive where the stop button was pressed</doc>
|
|
<type name="Drive"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="mount-added" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4215">Emitted when a mount is added.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4218">a #GMount that was added.</doc>
|
|
<type name="Mount"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="mount-changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4224">Emitted when a mount changes.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4227">a #GMount that changed.</doc>
|
|
<type name="Mount"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="mount-pre-unmount" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4233">May be emitted when a mount is about to be removed.
|
|
|
|
This signal depends on the backend and is only emitted if
|
|
GIO was used to unmount.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4236">a #GMount that is being unmounted.</doc>
|
|
<type name="Mount"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="mount-removed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4245">Emitted when a mount is removed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4248">a #GMount that was removed.</doc>
|
|
<type name="Mount"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="volume-added" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4254">Emitted when a mountable volume is added to the system.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4257">a #GVolume that was added.</doc>
|
|
<type name="Volume"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="volume-changed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4263">Emitted when mountable volume is changed.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4266">a #GVolume that changed.</doc>
|
|
<type name="Volume"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
<glib:signal name="volume-removed" when="last">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4272">Emitted when a mountable volume is removed from the system.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4275">a #GVolume that was removed.</doc>
|
|
<type name="Volume"/>
|
|
</parameter>
|
|
</parameters>
|
|
</glib:signal>
|
|
</class>
|
|
<record name="VolumeMonitorClass" c:type="GVolumeMonitorClass" glib:is-gtype-struct-for="VolumeMonitor">
|
|
<source-position filename="gvolumemonitor.h" line="129"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
<field name="volume_added">
|
|
<callback name="volume_added">
|
|
<source-position filename="gvolumemonitor.h" line="71"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="volume_removed">
|
|
<callback name="volume_removed">
|
|
<source-position filename="gvolumemonitor.h" line="73"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="volume_changed">
|
|
<callback name="volume_changed">
|
|
<source-position filename="gvolumemonitor.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="volume" transfer-ownership="none">
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_added">
|
|
<callback name="mount_added">
|
|
<source-position filename="gvolumemonitor.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_removed">
|
|
<callback name="mount_removed">
|
|
<source-position filename="gvolumemonitor.h" line="80"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_pre_unmount">
|
|
<callback name="mount_pre_unmount">
|
|
<source-position filename="gvolumemonitor.h" line="82"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="mount_changed">
|
|
<callback name="mount_changed">
|
|
<source-position filename="gvolumemonitor.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="drive_connected">
|
|
<callback name="drive_connected">
|
|
<source-position filename="gvolumemonitor.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="drive_disconnected">
|
|
<callback name="drive_disconnected">
|
|
<source-position filename="gvolumemonitor.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="drive_changed">
|
|
<callback name="drive_changed">
|
|
<source-position filename="gvolumemonitor.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="is_supported">
|
|
<callback name="is_supported">
|
|
<source-position filename="gvolumemonitor.h" line="96"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="get_connected_drives">
|
|
<callback name="get_connected_drives">
|
|
<source-position filename="gvolumemonitor.h" line="98"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41780">a #GList of connected #GDrive objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Drive"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41773">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_volumes">
|
|
<callback name="get_volumes">
|
|
<source-position filename="gvolumemonitor.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41830">a #GList of #GVolume objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Volume"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41823">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_mounts">
|
|
<callback name="get_mounts">
|
|
<source-position filename="gvolumemonitor.h" line="100"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41805">a #GList of #GMount objects.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="Mount"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41798">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_volume_for_uuid">
|
|
<callback name="get_volume_for_uuid">
|
|
<source-position filename="gvolumemonitor.h" line="102"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41816">a #GVolume or %NULL if no such volume is available.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41811">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="uuid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41812">the UUID to look for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="get_mount_for_uuid">
|
|
<callback name="get_mount_for_uuid">
|
|
<source-position filename="gvolumemonitor.h" line="105"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41791">a #GMount or %NULL if no such mount is available.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41786">a #GVolumeMonitor.</doc>
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="uuid" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41787">the UUID to look for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="adopt_orphan_mount" introspectable="0">
|
|
<callback name="adopt_orphan_mount" introspectable="0">
|
|
<source-position filename="gvolumemonitor.h" line="110"/>
|
|
<return-value>
|
|
<type name="Volume" c:type="GVolume*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount" transfer-ownership="none">
|
|
<type name="Mount" c:type="GMount*"/>
|
|
</parameter>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="drive_eject_button">
|
|
<callback name="drive_eject_button">
|
|
<source-position filename="gvolumemonitor.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="drive_stop_button">
|
|
<callback name="drive_stop_button">
|
|
<source-position filename="gvolumemonitor.h" line="118"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="volume_monitor" transfer-ownership="none">
|
|
<type name="VolumeMonitor" c:type="GVolumeMonitor*"/>
|
|
</parameter>
|
|
<parameter name="drive" transfer-ownership="none">
|
|
<type name="Drive" c:type="GDrive*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved1" introspectable="0">
|
|
<callback name="_g_reserved1">
|
|
<source-position filename="gvolumemonitor.h" line="123"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved2" introspectable="0">
|
|
<callback name="_g_reserved2">
|
|
<source-position filename="gvolumemonitor.h" line="124"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved3" introspectable="0">
|
|
<callback name="_g_reserved3">
|
|
<source-position filename="gvolumemonitor.h" line="125"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved4" introspectable="0">
|
|
<callback name="_g_reserved4">
|
|
<source-position filename="gvolumemonitor.h" line="126"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved5" introspectable="0">
|
|
<callback name="_g_reserved5">
|
|
<source-position filename="gvolumemonitor.h" line="127"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
<field name="_g_reserved6" introspectable="0">
|
|
<callback name="_g_reserved6">
|
|
<source-position filename="gvolumemonitor.h" line="128"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</callback>
|
|
</field>
|
|
</record>
|
|
<function-macro name="ZLIB_COMPRESSOR" c:identifier="G_ZLIB_COMPRESSOR" introspectable="0">
|
|
<source-position filename="gzlibcompressor.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ZLIB_COMPRESSOR_CLASS" c:identifier="G_ZLIB_COMPRESSOR_CLASS" introspectable="0">
|
|
<source-position filename="gzlibcompressor.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ZLIB_COMPRESSOR_GET_CLASS" c:identifier="G_ZLIB_COMPRESSOR_GET_CLASS" introspectable="0">
|
|
<source-position filename="gzlibcompressor.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ZLIB_DECOMPRESSOR" c:identifier="G_ZLIB_DECOMPRESSOR" introspectable="0">
|
|
<source-position filename="gzlibdecompressor.h" line="34"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ZLIB_DECOMPRESSOR_CLASS" c:identifier="G_ZLIB_DECOMPRESSOR_CLASS" introspectable="0">
|
|
<source-position filename="gzlibdecompressor.h" line="35"/>
|
|
<parameters>
|
|
<parameter name="k">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<function-macro name="ZLIB_DECOMPRESSOR_GET_CLASS" c:identifier="G_ZLIB_DECOMPRESSOR_GET_CLASS" introspectable="0">
|
|
<source-position filename="gzlibdecompressor.h" line="38"/>
|
|
<parameters>
|
|
<parameter name="o">
|
|
</parameter>
|
|
</parameters>
|
|
</function-macro>
|
|
<class name="ZlibCompressor" c:symbol-prefix="zlib_compressor" c:type="GZlibCompressor" parent="GObject.Object" glib:type-name="GZlibCompressor" glib:get-type="g_zlib_compressor_get_type" glib:type-struct="ZlibCompressorClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4335">Zlib decompression</doc>
|
|
<source-position filename="gzlibcompressor.h" line="45"/>
|
|
<implements name="Converter"/>
|
|
<constructor name="new" c:identifier="g_zlib_compressor_new" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42580">Creates a new #GZlibCompressor.</doc>
|
|
<source-position filename="gzlibcompressor.h" line="51"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42587">a new #GZlibCompressor</doc>
|
|
<type name="ZlibCompressor" c:type="GZlibCompressor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42582">The format to use for the compressed data</doc>
|
|
<type name="ZlibCompressorFormat" c:type="GZlibCompressorFormat"/>
|
|
</parameter>
|
|
<parameter name="level" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42583">compression level (0-9), -1 for default</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_file_info" c:identifier="g_zlib_compressor_get_file_info" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42569">Returns the #GZlibCompressor:file-info property.</doc>
|
|
<source-position filename="gzlibcompressor.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42575">a #GFileInfo, or %NULL</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="compressor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42571">a #GZlibCompressor</doc>
|
|
<type name="ZlibCompressor" c:type="GZlibCompressor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<method name="set_file_info" c:identifier="g_zlib_compressor_set_file_info" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42592">Sets @file_info in @compressor. If non-%NULL, and @compressor's
|
|
#GZlibCompressor:format property is %G_ZLIB_COMPRESSOR_FORMAT_GZIP,
|
|
it will be used to set the file name and modification time in
|
|
the GZIP header of the compressed data.
|
|
|
|
Note: it is an error to call this function while a compression is in
|
|
progress; it may only be called immediately after creation of @compressor,
|
|
or after resetting it with g_converter_reset().</doc>
|
|
<source-position filename="gzlibcompressor.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="compressor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42594">a #GZlibCompressor</doc>
|
|
<type name="ZlibCompressor" c:type="GZlibCompressor*"/>
|
|
</instance-parameter>
|
|
<parameter name="file_info" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42595">a #GFileInfo</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="file-info" version="2.26" writable="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4342">If set to a non-%NULL #GFileInfo object, and #GZlibCompressor:format is
|
|
%G_ZLIB_COMPRESSOR_FORMAT_GZIP, the compressor will write the file name
|
|
and modification time from the file info to the GZIP header.</doc>
|
|
<type name="FileInfo"/>
|
|
</property>
|
|
<property name="format" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="ZlibCompressorFormat"/>
|
|
</property>
|
|
<property name="level" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="gint" c:type="gint"/>
|
|
</property>
|
|
</class>
|
|
<record name="ZlibCompressorClass" c:type="GZlibCompressorClass" glib:is-gtype-struct-for="ZlibCompressor">
|
|
<source-position filename="gzlibcompressor.h" line="45"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<enumeration name="ZlibCompressorFormat" version="2.24" glib:type-name="GZlibCompressorFormat" glib:get-type="g_zlib_compressor_format_get_type" c:type="GZlibCompressorFormat">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="900">Used to select the type of data format to use for #GZlibDecompressor
|
|
and #GZlibCompressor.</doc>
|
|
<member name="zlib" value="0" c:identifier="G_ZLIB_COMPRESSOR_FORMAT_ZLIB" glib:nick="zlib">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="902">deflate compression with zlib header</doc>
|
|
</member>
|
|
<member name="gzip" value="1" c:identifier="G_ZLIB_COMPRESSOR_FORMAT_GZIP" glib:nick="gzip">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="903">gzip file format</doc>
|
|
</member>
|
|
<member name="raw" value="2" c:identifier="G_ZLIB_COMPRESSOR_FORMAT_RAW" glib:nick="raw">
|
|
<doc xml:space="preserve" filename="gioenums.h" line="904">deflate compression with no header</doc>
|
|
</member>
|
|
</enumeration>
|
|
<class name="ZlibDecompressor" c:symbol-prefix="zlib_decompressor" c:type="GZlibDecompressor" parent="GObject.Object" glib:type-name="GZlibDecompressor" glib:get-type="g_zlib_decompressor_get_type" glib:type-struct="ZlibDecompressorClass">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4353">Zlib decompression</doc>
|
|
<source-position filename="gzlibdecompressor.h" line="45"/>
|
|
<implements name="Converter"/>
|
|
<constructor name="new" c:identifier="g_zlib_decompressor_new" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42625">Creates a new #GZlibDecompressor.</doc>
|
|
<source-position filename="gzlibdecompressor.h" line="51"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42631">a new #GZlibDecompressor</doc>
|
|
<type name="ZlibDecompressor" c:type="GZlibDecompressor*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42627">The format to use for the compressed data</doc>
|
|
<type name="ZlibCompressorFormat" c:type="GZlibCompressorFormat"/>
|
|
</parameter>
|
|
</parameters>
|
|
</constructor>
|
|
<method name="get_file_info" c:identifier="g_zlib_decompressor_get_file_info" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42610">Retrieves the #GFileInfo constructed from the GZIP header data
|
|
of compressed data processed by @compressor, or %NULL if @decompressor's
|
|
#GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP,
|
|
or the header data was not fully processed yet, or it not present in the
|
|
data stream at all.</doc>
|
|
<source-position filename="gzlibdecompressor.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42620">a #GFileInfo, or %NULL</doc>
|
|
<type name="FileInfo" c:type="GFileInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<instance-parameter name="decompressor" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="42612">a #GZlibDecompressor</doc>
|
|
<type name="ZlibDecompressor" c:type="GZlibDecompressor*"/>
|
|
</instance-parameter>
|
|
</parameters>
|
|
</method>
|
|
<property name="file-info" version="2.26" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="4360">A #GFileInfo containing the information found in the GZIP header
|
|
of the data stream processed, or %NULL if the header was not yet
|
|
fully processed, is not present at all, or the compressor's
|
|
#GZlibDecompressor:format property is not %G_ZLIB_COMPRESSOR_FORMAT_GZIP.</doc>
|
|
<type name="FileInfo"/>
|
|
</property>
|
|
<property name="format" writable="1" construct-only="1" transfer-ownership="none">
|
|
<type name="ZlibCompressorFormat"/>
|
|
</property>
|
|
</class>
|
|
<record name="ZlibDecompressorClass" c:type="GZlibDecompressorClass" glib:is-gtype-struct-for="ZlibDecompressor">
|
|
<source-position filename="gzlibdecompressor.h" line="45"/>
|
|
<field name="parent_class">
|
|
<type name="GObject.ObjectClass" c:type="GObjectClass"/>
|
|
</field>
|
|
</record>
|
|
<function name="action_name_is_valid" c:identifier="g_action_name_is_valid" moved-to="Action.name_is_valid" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10682">Checks if @action_name is valid.
|
|
|
|
@action_name is valid if it consists only of alphanumeric characters,
|
|
plus '-' and '.'. The empty string is not a valid action name.
|
|
|
|
It is an error to call this function with a non-utf8 @action_name.
|
|
@action_name must not be %NULL.</doc>
|
|
<source-position filename="gaction.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10694">%TRUE if @action_name is valid</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10684">an potential action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="action_parse_detailed_name" c:identifier="g_action_parse_detailed_name" moved-to="Action.parse_detailed_name" version="2.38" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10699">Parses a detailed action name into its separate name and target
|
|
components.
|
|
|
|
Detailed action names can have three formats.
|
|
|
|
The first format is used to represent an action name with no target
|
|
value and consists of just an action name containing no whitespace
|
|
nor the characters ':', '(' or ')'. For example: "app.action".
|
|
|
|
The second format is used to represent an action with a target value
|
|
that is a non-empty string consisting only of alphanumerics, plus '-'
|
|
and '.'. In that case, the action name and target value are
|
|
separated by a double colon ("::"). For example:
|
|
"app.action::target".
|
|
|
|
The third format is used to represent an action with any type of
|
|
target value, including strings. The target value follows the action
|
|
name, surrounded in parens. For example: "app.action(42)". The
|
|
target value is parsed using g_variant_parse(). If a tuple-typed
|
|
value is desired, it must be specified in the same way, resulting in
|
|
two sets of parens, for example: "app.action((1,2,3))". A string
|
|
target can be specified this way as well: "app.action('target')".
|
|
For strings, this third format must be used if * target value is
|
|
empty or contains characters other than alphanumerics, '-' and '.'.</doc>
|
|
<source-position filename="gaction.h" line="87"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10731">%TRUE if successful, else %FALSE with @error set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="detailed_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10701">a detailed action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="action_name" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10702">the action name</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
<parameter name="target_value" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10703">the target value, or %NULL for no target</doc>
|
|
<type name="GLib.Variant" c:type="GVariant**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="action_print_detailed_name" c:identifier="g_action_print_detailed_name" moved-to="Action.print_detailed_name" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10736">Formats a detailed action name from @action_name and @target_value.
|
|
|
|
It is an error to call this function with an invalid action name.
|
|
|
|
This function is the opposite of g_action_parse_detailed_name().
|
|
It will produce a string that can be parsed back to the @action_name
|
|
and @target_value by that function.
|
|
|
|
See that function for the types of strings that will be printed by
|
|
this function.</doc>
|
|
<source-position filename="gaction.h" line="93"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10752">a detailed format string</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="action_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10738">a valid action name</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="target_value" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10739">a #GVariant target value, or %NULL</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_create_from_commandline" c:identifier="g_app_info_create_from_commandline" moved-to="AppInfo.create_from_commandline" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10793">Creates a new #GAppInfo from the given information.
|
|
|
|
Note that for @commandline, the quoting rules of the Exec key of the
|
|
[freedesktop.org Desktop Entry Specification](http://freedesktop.org/Standards/desktop-entry-spec)
|
|
are applied. For example, if the @commandline contains
|
|
percent-encoded URIs, the percent-character must be doubled in order to prevent it from
|
|
being swallowed by Exec key unquoting. See the specification for exact quoting rules.</doc>
|
|
<source-position filename="gappinfo.h" line="150"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10808">new #GAppInfo for given command.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="commandline" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10795">the commandline to use</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="application_name" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10796">the application name, or %NULL to use @commandline</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10797">flags that can specify details of the created #GAppInfo</doc>
|
|
<type name="AppInfoCreateFlags" c:type="GAppInfoCreateFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_get_all" c:identifier="g_app_info_get_all" moved-to="AppInfo.get_all">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10852">Gets a list of all of the applications currently registered
|
|
on this system.
|
|
|
|
For desktop files, this includes applications that have
|
|
`NoDisplay=true` set or are excluded from display by means
|
|
of `OnlyShowIn` or `NotShowIn`. See g_app_info_should_show().
|
|
The returned list does not include applications which have
|
|
the `Hidden` key set.</doc>
|
|
<source-position filename="gappinfo.h" line="234"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10864">a newly allocated #GList of references to #GAppInfos.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
</function>
|
|
<function name="app_info_get_all_for_type" c:identifier="g_app_info_get_all_for_type" moved-to="AppInfo.get_all_for_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10868">Gets a list of all #GAppInfos for a given content type,
|
|
including the recommended and fallback #GAppInfos. See
|
|
g_app_info_get_recommended_for_type() and
|
|
g_app_info_get_fallback_for_type().</doc>
|
|
<source-position filename="gappinfo.h" line="236"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10877">#GList of #GAppInfos
|
|
for given @content_type or %NULL on error.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10870">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_get_default_for_type" c:identifier="g_app_info_get_default_for_type" moved-to="AppInfo.get_default_for_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10895">Gets the default #GAppInfo for a given content type.</doc>
|
|
<source-position filename="gappinfo.h" line="245"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10903">#GAppInfo for given @content_type or
|
|
%NULL on error.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10897">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="must_support_uris" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10898">if %TRUE, the #GAppInfo is expected to
|
|
support URIs</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_get_default_for_uri_scheme" c:identifier="g_app_info_get_default_for_uri_scheme" moved-to="AppInfo.get_default_for_uri_scheme">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10908">Gets the default application for handling URIs with
|
|
the given URI scheme. A URI scheme is the initial part
|
|
of the URI, up to but not including the ':', e.g. "http",
|
|
"ftp" or "sip".</doc>
|
|
<source-position filename="gappinfo.h" line="248"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10917">#GAppInfo for given @uri_scheme or %NULL on error.</doc>
|
|
<type name="AppInfo" c:type="GAppInfo*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri_scheme" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10910">a string containing a URI scheme.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_get_fallback_for_type" c:identifier="g_app_info_get_fallback_for_type" moved-to="AppInfo.get_fallback_for_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10956">Gets a list of fallback #GAppInfos for a given content type, i.e.
|
|
those applications which claim to support the given content type
|
|
by MIME type subclassing and not directly.</doc>
|
|
<source-position filename="gappinfo.h" line="240"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10964">#GList of #GAppInfos
|
|
for given @content_type or %NULL on error.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="10958">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_get_recommended_for_type" c:identifier="g_app_info_get_recommended_for_type" moved-to="AppInfo.get_recommended_for_type" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11007">Gets a list of recommended #GAppInfos for a given content type, i.e.
|
|
those applications which claim to support the given content type exactly,
|
|
and not by MIME type subclassing.
|
|
Note that the first application of the list is the last used one, i.e.
|
|
the last one for which g_app_info_set_as_last_used_for_type() has been
|
|
called.</doc>
|
|
<source-position filename="gappinfo.h" line="238"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11018">#GList of #GAppInfos
|
|
for given @content_type or %NULL on error.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="AppInfo"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11009">the content type to find a #GAppInfo for</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_launch_default_for_uri" c:identifier="g_app_info_launch_default_for_uri" moved-to="AppInfo.launch_default_for_uri" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11080">Utility function that launches the default application
|
|
registered to handle the specified uri. Synchronous I/O
|
|
is done on the uri to detect the type of the file if
|
|
required.
|
|
|
|
The D-Bus–activated applications don't have to be started if your application
|
|
terminates too soon after this function. To prevent this, use
|
|
g_app_info_launch_default_for_uri_async() instead.</doc>
|
|
<source-position filename="gappinfo.h" line="251"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11095">%TRUE on success, %FALSE on error.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11082">the uri to show</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11083">an optional #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_launch_default_for_uri_async" c:identifier="g_app_info_launch_default_for_uri_async" moved-to="AppInfo.launch_default_for_uri_async" version="2.50">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11099">Async version of g_app_info_launch_default_for_uri().
|
|
|
|
This version is useful if you are interested in receiving
|
|
error information in the case where the application is
|
|
sandboxed and the portal may present an application chooser
|
|
dialog to the user.
|
|
|
|
This is also useful if you want to be sure that the D-Bus–activated
|
|
applications are really started before termination and if you are interested
|
|
in receiving error information from their activation.</doc>
|
|
<source-position filename="gappinfo.h" line="256"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11101">the uri to show</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="context" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11102">an optional #GAppLaunchContext</doc>
|
|
<type name="AppLaunchContext" c:type="GAppLaunchContext*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11103">a #GCancellable</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="4">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11104">a #GAsyncReadyCallback to call when the request is done</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11105">data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_launch_default_for_uri_finish" c:identifier="g_app_info_launch_default_for_uri_finish" moved-to="AppInfo.launch_default_for_uri_finish" version="2.50" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11122">Finishes an asynchronous launch-default-for-uri operation.</doc>
|
|
<source-position filename="gappinfo.h" line="262"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11129">%TRUE if the launch was successful, %FALSE if @error is set</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="result" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11124">a #GAsyncResult</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="app_info_reset_type_associations" c:identifier="g_app_info_reset_type_associations" moved-to="AppInfo.reset_type_associations" version="2.20">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11219">Removes all changes to the type associations done by
|
|
g_app_info_set_as_default_for_type(),
|
|
g_app_info_set_as_default_for_extension(),
|
|
g_app_info_add_supports_type() or
|
|
g_app_info_remove_supports_type().</doc>
|
|
<source-position filename="gappinfo.h" line="243"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="content_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="11221">a content type</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="async_initable_newv_async" c:identifier="g_async_initable_newv_async" moved-to="AsyncInitable.newv_async" version="2.22" deprecated="1" deprecated-version="2.54">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12651">Helper function for constructing #GAsyncInitable object. This is
|
|
similar to g_object_newv() but also initializes the object asynchronously.
|
|
|
|
When the initialization is finished, @callback will be called. You can
|
|
then call g_async_initable_new_finish() to get the new object and check
|
|
for any errors.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
|
g_async_initable_init_async() instead. See #GParameter for more information.</doc-deprecated>
|
|
<source-position filename="gasyncinitable.h" line="102"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12653">a #GType supporting #GAsyncInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="n_parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12654">the number of parameters in @parameters</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12655">the parameters to use to construct the object</doc>
|
|
<type name="GObject.Parameter" c:type="GParameter*"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12656">the [I/O priority][io-priority] of the operation</doc>
|
|
<type name="gint" c:type="int"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12657">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12658">a #GAsyncReadyCallback to call when the initialization is
|
|
finished</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12660">the data to pass to callback function</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_get" c:identifier="g_bus_get" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12969">Asynchronously connects to the message bus specified by @bus_type.
|
|
|
|
When the operation is finished, @callback will be invoked. You can
|
|
then call g_bus_get_finish() to get the result of the operation.
|
|
|
|
This is an asynchronous failable function. See g_bus_get_sync() for
|
|
the synchronous version.</doc>
|
|
<source-position filename="gdbusconnection.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12971">a #GBusType</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12972">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12973">a #GAsyncReadyCallback to call when the request is satisfied</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12974">the data to pass to @callback</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_get_finish" c:identifier="g_bus_get_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12988">Finishes an operation started with g_bus_get().
|
|
|
|
The returned object is a singleton, that is, shared with other
|
|
callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
|
|
event that you need a private message bus connection, use
|
|
g_dbus_address_get_for_bus_sync() and
|
|
g_dbus_connection_new_for_address().
|
|
|
|
Note that the returned #GDBusConnection object will (usually) have
|
|
the #GDBusConnection:exit-on-close property set to %TRUE.</doc>
|
|
<source-position filename="gdbusconnection.h" line="47"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13005">a #GDBusConnection or %NULL if @error is set.
|
|
Free with g_object_unref().</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="12990">a #GAsyncResult obtained from the #GAsyncReadyCallback passed
|
|
to g_bus_get()</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_get_sync" c:identifier="g_bus_get_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13011">Synchronously connects to the message bus specified by @bus_type.
|
|
Note that the returned object may shared with other callers,
|
|
e.g. if two separate parts of a process calls this function with
|
|
the same @bus_type, they will share the same object.
|
|
|
|
This is a synchronous failable function. See g_bus_get() and
|
|
g_bus_get_finish() for the asynchronous version.
|
|
|
|
The returned object is a singleton, that is, shared with other
|
|
callers of g_bus_get() and g_bus_get_sync() for @bus_type. In the
|
|
event that you need a private message bus connection, use
|
|
g_dbus_address_get_for_bus_sync() and
|
|
g_dbus_connection_new_for_address().
|
|
|
|
Note that the returned #GDBusConnection object will (usually) have
|
|
the #GDBusConnection:exit-on-close property set to %TRUE.</doc>
|
|
<source-position filename="gdbusconnection.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13034">a #GDBusConnection or %NULL if @error is set.
|
|
Free with g_object_unref().</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13013">a #GBusType</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13014">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_own_name" c:identifier="g_bus_own_name" shadowed-by="bus_own_name_with_closures" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13040">Starts acquiring @name on the bus specified by @bus_type and calls
|
|
@name_acquired_handler and @name_lost_handler when the name is
|
|
acquired respectively lost. Callbacks will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this function from.
|
|
|
|
You are guaranteed that one of the @name_acquired_handler and @name_lost_handler
|
|
callbacks will be invoked after calling this function - there are three
|
|
possible cases:
|
|
|
|
- @name_lost_handler with a %NULL connection (if a connection to the bus
|
|
can't be made).
|
|
|
|
- @bus_acquired_handler then @name_lost_handler (if the name can't be
|
|
obtained)
|
|
|
|
- @bus_acquired_handler then @name_acquired_handler (if the name was
|
|
obtained).
|
|
|
|
When you are done owning the name, just call g_bus_unown_name()
|
|
with the owner id this function returns.
|
|
|
|
If the name is acquired or lost (for example another application
|
|
could acquire the name if you allow replacement or the application
|
|
currently owning the name exits), the handlers are also invoked.
|
|
If the #GDBusConnection that is used for attempting to own the name
|
|
closes, then @name_lost_handler is invoked since it is no longer
|
|
possible for other processes to access the process.
|
|
|
|
You cannot use g_bus_own_name() several times for the same name (unless
|
|
interleaved with calls to g_bus_unown_name()) - only the first call
|
|
will work.
|
|
|
|
Another guarantee is that invocations of @name_acquired_handler
|
|
and @name_lost_handler are guaranteed to alternate; that
|
|
is, if @name_acquired_handler is invoked then you are
|
|
guaranteed that the next time one of the handlers is invoked, it
|
|
will be @name_lost_handler. The reverse is also true.
|
|
|
|
If you plan on exporting objects (using e.g.
|
|
g_dbus_connection_register_object()), note that it is generally too late
|
|
to export the objects in @name_acquired_handler. Instead, you can do this
|
|
in @bus_acquired_handler since you are guaranteed that this will run
|
|
before @name is requested from the bus.
|
|
|
|
This behavior makes it very simple to write applications that wants
|
|
to [own names][gdbus-owning-names] and export objects.
|
|
Simply register objects to be exported in @bus_acquired_handler and
|
|
unregister the objects (if any) in @name_lost_handler.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13101">an identifier (never 0) that an be used with
|
|
g_bus_unown_name() to stop owning the name.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13042">the type of bus to own a name on</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13043">the well-known name to own</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13044">a set of flags from the #GBusNameOwnerFlags enumeration</doc>
|
|
<type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
|
|
</parameter>
|
|
<parameter name="bus_acquired_handler" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13045">handler to invoke when connected to the bus of type @bus_type or %NULL</doc>
|
|
<type name="BusAcquiredCallback" c:type="GBusAcquiredCallback"/>
|
|
</parameter>
|
|
<parameter name="name_acquired_handler" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13046">handler to invoke when @name is acquired or %NULL</doc>
|
|
<type name="BusNameAcquiredCallback" c:type="GBusNameAcquiredCallback"/>
|
|
</parameter>
|
|
<parameter name="name_lost_handler" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="6" destroy="7">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13047">handler to invoke when @name is lost or %NULL</doc>
|
|
<type name="BusNameLostCallback" c:type="GBusNameLostCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13048">user data to pass to handlers</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13049">function for freeing @user_data or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_own_name_on_connection" c:identifier="g_bus_own_name_on_connection" shadowed-by="bus_own_name_on_connection_with_closures" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13107">Like g_bus_own_name() but takes a #GDBusConnection instead of a
|
|
#GBusType.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="86"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13120">an identifier (never 0) that an be used with
|
|
g_bus_unown_name() to stop owning the name</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13109">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13110">the well-known name to own</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13111">a set of flags from the #GBusNameOwnerFlags enumeration</doc>
|
|
<type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
|
|
</parameter>
|
|
<parameter name="name_acquired_handler" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13112">handler to invoke when @name is acquired or %NULL</doc>
|
|
<type name="BusNameAcquiredCallback" c:type="GBusNameAcquiredCallback"/>
|
|
</parameter>
|
|
<parameter name="name_lost_handler" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13113">handler to invoke when @name is lost or %NULL</doc>
|
|
<type name="BusNameLostCallback" c:type="GBusNameLostCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13114">user data to pass to handlers</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13115">function for freeing @user_data or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_own_name_on_connection_with_closures" c:identifier="g_bus_own_name_on_connection_with_closures" shadows="bus_own_name_on_connection" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13126">Version of g_bus_own_name_on_connection() using closures instead of
|
|
callbacks for easier binding in other languages.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="103"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13139">an identifier (never 0) that an be used with
|
|
g_bus_unown_name() to stop owning the name.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13128">a #GDBusConnection</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13129">the well-known name to own</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13130">a set of flags from the #GBusNameOwnerFlags enumeration</doc>
|
|
<type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
|
|
</parameter>
|
|
<parameter name="name_acquired_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13131">#GClosure to invoke when @name is
|
|
acquired or %NULL</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
<parameter name="name_lost_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13133">#GClosure to invoke when @name is lost
|
|
or %NULL</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_own_name_with_closures" c:identifier="g_bus_own_name_with_closures" shadows="bus_own_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13145">Version of g_bus_own_name() using closures instead of callbacks for
|
|
easier binding in other languages.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13160">an identifier (never 0) that an be used with
|
|
g_bus_unown_name() to stop owning the name.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13147">the type of bus to own a name on</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13148">the well-known name to own</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13149">a set of flags from the #GBusNameOwnerFlags enumeration</doc>
|
|
<type name="BusNameOwnerFlags" c:type="GBusNameOwnerFlags"/>
|
|
</parameter>
|
|
<parameter name="bus_acquired_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13150">#GClosure to invoke when connected to
|
|
the bus of type @bus_type or %NULL</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
<parameter name="name_acquired_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13152">#GClosure to invoke when @name is
|
|
acquired or %NULL</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
<parameter name="name_lost_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13154">#GClosure to invoke when @name is lost or
|
|
%NULL</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_unown_name" c:identifier="g_bus_unown_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13166">Stops owning a name.</doc>
|
|
<source-position filename="gdbusnameowning.h" line="111"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="owner_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13168">an identifier obtained from g_bus_own_name()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_unwatch_name" c:identifier="g_bus_unwatch_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13176">Stops watching a name.</doc>
|
|
<source-position filename="gdbusnamewatching.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="watcher_id" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13178">An identifier obtained from g_bus_watch_name()</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_watch_name" c:identifier="g_bus_watch_name" shadowed-by="bus_watch_name_with_closures" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13186">Starts watching @name on the bus specified by @bus_type and calls
|
|
@name_appeared_handler and @name_vanished_handler when the name is
|
|
known to have a owner respectively known to lose its
|
|
owner. Callbacks will be invoked in the
|
|
[thread-default main context][g-main-context-push-thread-default]
|
|
of the thread you are calling this function from.
|
|
|
|
You are guaranteed that one of the handlers will be invoked after
|
|
calling this function. When you are done watching the name, just
|
|
call g_bus_unwatch_name() with the watcher id this function
|
|
returns.
|
|
|
|
If the name vanishes or appears (for example the application owning
|
|
the name could restart), the handlers are also invoked. If the
|
|
#GDBusConnection that is used for watching the name disconnects, then
|
|
@name_vanished_handler is invoked since it is no longer
|
|
possible to access the name.
|
|
|
|
Another guarantee is that invocations of @name_appeared_handler
|
|
and @name_vanished_handler are guaranteed to alternate; that
|
|
is, if @name_appeared_handler is invoked then you are
|
|
guaranteed that the next time one of the handlers is invoked, it
|
|
will be @name_vanished_handler. The reverse is also true.
|
|
|
|
This behavior makes it very simple to write applications that want
|
|
to take action when a certain [name exists][gdbus-watching-names].
|
|
Basically, the application should create object proxies in
|
|
@name_appeared_handler and destroy them again (if any) in
|
|
@name_vanished_handler.</doc>
|
|
<source-position filename="gdbusnamewatching.h" line="69"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13226">An identifier (never 0) that an be used with
|
|
g_bus_unwatch_name() to stop watching the name.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13188">The type of bus to watch a name on.</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13189">The name (well-known or unique) to watch.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13190">Flags from the #GBusNameWatcherFlags enumeration.</doc>
|
|
<type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
|
|
</parameter>
|
|
<parameter name="name_appeared_handler" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13191">Handler to invoke when @name is known to exist or %NULL.</doc>
|
|
<type name="BusNameAppearedCallback" c:type="GBusNameAppearedCallback"/>
|
|
</parameter>
|
|
<parameter name="name_vanished_handler" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13192">Handler to invoke when @name is known to not exist or %NULL.</doc>
|
|
<type name="BusNameVanishedCallback" c:type="GBusNameVanishedCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13193">User data to pass to handlers.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13194">Function for freeing @user_data or %NULL.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_watch_name_on_connection" c:identifier="g_bus_watch_name_on_connection" shadowed-by="bus_watch_name_on_connection_with_closures" version="2.26" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13232">Like g_bus_watch_name() but takes a #GDBusConnection instead of a
|
|
#GBusType.</doc>
|
|
<source-position filename="gdbusnamewatching.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13245">An identifier (never 0) that an be used with
|
|
g_bus_unwatch_name() to stop watching the name.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13234">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13235">The name (well-known or unique) to watch.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13236">Flags from the #GBusNameWatcherFlags enumeration.</doc>
|
|
<type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
|
|
</parameter>
|
|
<parameter name="name_appeared_handler" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13237">Handler to invoke when @name is known to exist or %NULL.</doc>
|
|
<type name="BusNameAppearedCallback" c:type="GBusNameAppearedCallback"/>
|
|
</parameter>
|
|
<parameter name="name_vanished_handler" transfer-ownership="none" nullable="1" allow-none="1" scope="notified" closure="5" destroy="6">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13238">Handler to invoke when @name is known to not exist or %NULL.</doc>
|
|
<type name="BusNameVanishedCallback" c:type="GBusNameVanishedCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13239">User data to pass to handlers.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="user_data_free_func" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13240">Function for freeing @user_data or %NULL.</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_watch_name_on_connection_with_closures" c:identifier="g_bus_watch_name_on_connection_with_closures" shadows="bus_watch_name_on_connection" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13251">Version of g_bus_watch_name_on_connection() using closures instead of callbacks for
|
|
easier binding in other languages.</doc>
|
|
<source-position filename="gdbusnamewatching.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13264">An identifier (never 0) that an be used with
|
|
g_bus_unwatch_name() to stop watching the name.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="connection" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13253">A #GDBusConnection.</doc>
|
|
<type name="DBusConnection" c:type="GDBusConnection*"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13254">The name (well-known or unique) to watch.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13255">Flags from the #GBusNameWatcherFlags enumeration.</doc>
|
|
<type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
|
|
</parameter>
|
|
<parameter name="name_appeared_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13256">#GClosure to invoke when @name is known
|
|
to exist or %NULL.</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
<parameter name="name_vanished_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13258">#GClosure to invoke when @name is known
|
|
to not exist or %NULL.</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="bus_watch_name_with_closures" c:identifier="g_bus_watch_name_with_closures" shadows="bus_watch_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13270">Version of g_bus_watch_name() using closures instead of callbacks for
|
|
easier binding in other languages.</doc>
|
|
<source-position filename="gdbusnamewatching.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13283">An identifier (never 0) that an be used with
|
|
g_bus_unwatch_name() to stop watching the name.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13272">The type of bus to watch a name on.</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13273">The name (well-known or unique) to watch.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13274">Flags from the #GBusNameWatcherFlags enumeration.</doc>
|
|
<type name="BusNameWatcherFlags" c:type="GBusNameWatcherFlags"/>
|
|
</parameter>
|
|
<parameter name="name_appeared_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13275">#GClosure to invoke when @name is known
|
|
to exist or %NULL.</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
<parameter name="name_vanished_closure" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13277">#GClosure to invoke when @name is known
|
|
to not exist or %NULL.</doc>
|
|
<type name="GObject.Closure" c:type="GClosure*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_can_be_executable" c:identifier="g_content_type_can_be_executable">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13618">Checks if a content type can be executable. Note that for instance
|
|
things like text files can be executables (i.e. scripts and batch files).</doc>
|
|
<source-position filename="gcontenttype.h" line="55"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13625">%TRUE if the file type corresponds to a type that
|
|
can be executable, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13620">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_equals" c:identifier="g_content_type_equals">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13630">Compares two content types for equality.</doc>
|
|
<source-position filename="gcontenttype.h" line="33"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13637">%TRUE if the two strings are identical or equivalent,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13632">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="type2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13633">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_from_mime_type" c:identifier="g_content_type_from_mime_type" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13642">Tries to find a content type based on the mime type name.</doc>
|
|
<source-position filename="gcontenttype.h" line="58"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13648">Newly allocated string with content type or
|
|
%NULL. Free with g_free()</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mime_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13644">a mime type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_get_description" c:identifier="g_content_type_get_description">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13654">Gets the human readable description of the content type.</doc>
|
|
<source-position filename="gcontenttype.h" line="44"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13660">a short description of the content type @type. Free the
|
|
returned string with g_free()</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13656">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_get_generic_icon_name" c:identifier="g_content_type_get_generic_icon_name" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13665">Gets the generic icon name for a content type.
|
|
|
|
See the
|
|
[shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
|
|
specification for more on the generic icon name.</doc>
|
|
<source-position filename="gcontenttype.h" line="52"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13675">the registered generic icon name for the given @type,
|
|
or %NULL if unknown. Free with g_free()</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13667">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_get_icon" c:identifier="g_content_type_get_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13681">Gets the icon for a content type.</doc>
|
|
<source-position filename="gcontenttype.h" line="48"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13687">#GIcon corresponding to the content type. Free the returned
|
|
object with g_object_unref()</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13683">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_get_mime_dirs" c:identifier="g_content_type_get_mime_dirs" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13692">Get the list of directories which MIME data is loaded from. See
|
|
g_content_type_set_mime_dirs() for details.</doc>
|
|
<source-position filename="gcontenttype.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13698">%NULL-terminated list of
|
|
directories to load MIME data from, including any `mime/` subdirectory,
|
|
and with the first directory to try listed first</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
</function>
|
|
<function name="content_type_get_mime_type" c:identifier="g_content_type_get_mime_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13705">Gets the mime type for the content type, if one is registered.</doc>
|
|
<source-position filename="gcontenttype.h" line="46"/>
|
|
<return-value transfer-ownership="full" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13711">the registered mime type for the
|
|
given @type, or %NULL if unknown; free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13707">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_get_symbolic_icon" c:identifier="g_content_type_get_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13716">Gets the symbolic icon for a content type.</doc>
|
|
<source-position filename="gcontenttype.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13722">symbolic #GIcon corresponding to the content type.
|
|
Free the returned object with g_object_unref()</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13718">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_guess" c:identifier="g_content_type_guess">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13728">Guesses the content type based on example data. If the function is
|
|
uncertain, @result_uncertain will be set to %TRUE. Either @filename
|
|
or @data may be %NULL, in which case the guess will be based solely
|
|
on the other argument.</doc>
|
|
<source-position filename="gcontenttype.h" line="61"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13741">a string indicating a guessed content type for the
|
|
given data. Free with g_free()</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="filename" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13730">a string, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13731">a stream of data, or %NULL</doc>
|
|
<array length="2" zero-terminated="0" c:type="const guchar*">
|
|
<type name="guint8" c:type="guchar"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="data_size" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13732">the size of @data</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="result_uncertain" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13733">return location for the certainty
|
|
of the result, or %NULL</doc>
|
|
<type name="gboolean" c:type="gboolean*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_guess_for_tree" c:identifier="g_content_type_guess_for_tree" version="2.18">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13746">Tries to guess the type of the tree with root @root, by
|
|
looking at the files it contains. The result is an array
|
|
of content types, with the best guess coming first.
|
|
|
|
The types returned all have the form x-content/foo, e.g.
|
|
x-content/audio-cdda (for audio CDs) or x-content/image-dcf
|
|
(for a camera memory card). See the
|
|
[shared-mime-info](http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec)
|
|
specification for more on x-content types.
|
|
|
|
This function is useful in the implementation of
|
|
g_mount_guess_content_type().</doc>
|
|
<source-position filename="gcontenttype.h" line="67"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13763">an %NULL-terminated
|
|
array of zero or more content types. Free with g_strfreev()</doc>
|
|
<array c:type="gchar**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="root" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13748">the root of the tree to guess a type for</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_is_a" c:identifier="g_content_type_is_a">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13769">Determines if @type is a subset of @supertype.</doc>
|
|
<source-position filename="gcontenttype.h" line="36"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13776">%TRUE if @type is a kind of @supertype,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13771">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="supertype" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13772">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_is_mime_type" c:identifier="g_content_type_is_mime_type" version="2.52">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13781">Determines if @type is a subset of @mime_type.
|
|
Convenience wrapper around g_content_type_is_a().</doc>
|
|
<source-position filename="gcontenttype.h" line="39"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13789">%TRUE if @type is a kind of @mime_type,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13783">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="mime_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13784">a mime type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_is_unknown" c:identifier="g_content_type_is_unknown">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13795">Checks if the content type is the generic "unknown" type.
|
|
On UNIX this is the "application/octet-stream" mimetype,
|
|
while on win32 it is "*" and on OSX it is a dynamic type
|
|
or octet-stream.</doc>
|
|
<source-position filename="gcontenttype.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13804">%TRUE if the type is the unknown type.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13797">a content type string</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_type_set_mime_dirs" c:identifier="g_content_type_set_mime_dirs" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13808">Set the list of directories used by GIO to load the MIME database.
|
|
If @dirs is %NULL, the directories used are the default:
|
|
|
|
- the `mime` subdirectory of the directory in `$XDG_DATA_HOME`
|
|
- the `mime` subdirectory of every directory in `$XDG_DATA_DIRS`
|
|
|
|
This function is intended to be used when writing tests that depend on
|
|
information stored in the MIME database, in order to control the data.
|
|
|
|
Typically, in case your tests use %G_TEST_OPTION_ISOLATE_DIRS, but they
|
|
depend on the system’s MIME database, you should call this function
|
|
with @dirs set to %NULL before calling g_test_init(), for instance:
|
|
|
|
|[<!-- language="C" -->
|
|
// Load MIME data from the system
|
|
g_content_type_set_mime_dirs (NULL);
|
|
// Isolate the environment
|
|
g_test_init (&argc, &argv, G_TEST_OPTION_ISOLATE_DIRS, NULL);
|
|
|
|
…
|
|
|
|
return g_test_run ();
|
|
]|</doc>
|
|
<source-position filename="gcontenttype.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="dirs" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13810">%NULL-terminated list of
|
|
directories to load MIME data from, including any `mime/` subdirectory,
|
|
and with the first directory to try listed first</doc>
|
|
<array c:type="const gchar* const*">
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</array>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="content_types_get_registered" c:identifier="g_content_types_get_registered">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13842">Gets a list of strings containing all the registered content types
|
|
known to the system. The list and its data should be freed using
|
|
`g_list_free_full (list, g_free)`.</doc>
|
|
<source-position filename="gcontenttype.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="13849">list of the registered
|
|
content types</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="utf8"/>
|
|
</type>
|
|
</return-value>
|
|
</function>
|
|
<function name="dbus_address_escape_value" c:identifier="g_dbus_address_escape_value" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14980">Escape @string so it can appear in a D-Bus address as the value
|
|
part of a key-value pair.
|
|
|
|
For instance, if @string is `/run/bus-for-:0`,
|
|
this function would return `/run/bus-for-%3A0`,
|
|
which could be used in a D-Bus address like
|
|
`unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=/run/bus-for-%3A0`.</doc>
|
|
<source-position filename="gdbusaddress.h" line="33"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14993">a copy of @string with all
|
|
non-optionally-escaped bytes escaped</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14982">an unescaped string to be included in a D-Bus address
|
|
as the value in a key-value pair</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_address_get_for_bus_sync" c:identifier="g_dbus_address_get_for_bus_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="14999">Synchronously looks up the D-Bus address for the well-known message
|
|
bus instance specified by @bus_type. This may involve using various
|
|
platform specific mechanisms.
|
|
|
|
The returned address will be in the
|
|
[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).</doc>
|
|
<source-position filename="gdbusaddress.h" line="59"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15012">a valid D-Bus address string for @bus_type or
|
|
%NULL if @error is set</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="bus_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15001">a #GBusType</doc>
|
|
<type name="BusType" c:type="GBusType"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15002">a #GCancellable or %NULL</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_address_get_stream" c:identifier="g_dbus_address_get_stream" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15018">Asynchronously connects to an endpoint specified by @address and
|
|
sets up the connection so it is in a state to run the client-side
|
|
of the D-Bus authentication conversation. @address must be in the
|
|
[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
|
|
|
|
When the operation is finished, @callback will be invoked. You can
|
|
then call g_dbus_address_get_stream_finish() to get the result of
|
|
the operation.
|
|
|
|
This is an asynchronous failable function. See
|
|
g_dbus_address_get_stream_sync() for the synchronous version.</doc>
|
|
<source-position filename="gdbusaddress.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15020">A valid D-Bus address.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15021">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="3">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15022">A #GAsyncReadyCallback to call when the request is satisfied.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15023">Data to pass to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_address_get_stream_finish" c:identifier="g_dbus_address_get_stream_finish" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15041">Finishes an operation started with g_dbus_address_get_stream().</doc>
|
|
<source-position filename="gdbusaddress.h" line="48"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15049">A #GIOStream or %NULL if @error is set.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="res" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15043">A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().</doc>
|
|
<type name="AsyncResult" c:type="GAsyncResult*"/>
|
|
</parameter>
|
|
<parameter name="out_guid" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15044">%NULL or return location to store the GUID extracted from @address, if any.</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_address_get_stream_sync" c:identifier="g_dbus_address_get_stream_sync" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15054">Synchronously connects to an endpoint specified by @address and
|
|
sets up the connection so it is in a state to run the client-side
|
|
of the D-Bus authentication conversation. @address must be in the
|
|
[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
|
|
|
|
This is a synchronous failable function. See
|
|
g_dbus_address_get_stream() for the asynchronous version.</doc>
|
|
<source-position filename="gdbusaddress.h" line="53"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15069">A #GIOStream or %NULL if @error is set.</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="address" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15056">A valid D-Bus address.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="out_guid" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15057">%NULL or return location to store the GUID extracted from @address, if any.</doc>
|
|
<type name="utf8" c:type="gchar**"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15058">A #GCancellable or %NULL.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_annotation_info_lookup" c:identifier="g_dbus_annotation_info_lookup" moved-to="DBusAnnotationInfo.lookup" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15074">Looks up the value of an annotation.
|
|
|
|
The cost of this function is O(n) in number of annotations.</doc>
|
|
<source-position filename="gdbusintrospection.h" line="183"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15083">The value or %NULL if not found. Do not free, it is owned by @annotations.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="annotations" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15076">A %NULL-terminated array of annotations or %NULL.</doc>
|
|
<array c:type="GDBusAnnotationInfo**">
|
|
<type name="DBusAnnotationInfo" c:type="GDBusAnnotationInfo*"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="15077">The name of the annotation to look up.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_encode_gerror" c:identifier="g_dbus_error_encode_gerror" moved-to="DBusError.encode_gerror" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16381">Creates a D-Bus error name to use for @error. If @error matches
|
|
a registered error (cf. g_dbus_error_register_error()), the corresponding
|
|
D-Bus error name will be returned.
|
|
|
|
Otherwise the a name of the form
|
|
`org.gtk.GDBus.UnmappedGError.Quark._ESCAPED_QUARK_NAME.Code_ERROR_CODE`
|
|
will be used. This allows other GDBus applications to map the error
|
|
on the wire back to a #GError using g_dbus_error_new_for_dbus_error().
|
|
|
|
This function is typically only used in object mappings to put a
|
|
#GError on the wire. Regular applications should not use it.</doc>
|
|
<source-position filename="gdbuserror.h" line="105"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16397">A D-Bus error name (never %NULL). Free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16383">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_get_remote_error" c:identifier="g_dbus_error_get_remote_error" moved-to="DBusError.get_remote_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16402">Gets the D-Bus error name used for @error, if any.
|
|
|
|
This function is guaranteed to return a D-Bus error name for all
|
|
#GErrors returned from functions handling remote method calls
|
|
(e.g. g_dbus_connection_call_finish()) unless
|
|
g_dbus_error_strip_remote_error() has been used on @error.</doc>
|
|
<source-position filename="gdbuserror.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16413">an allocated string or %NULL if the D-Bus error name
|
|
could not be found. Free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16404">a #GError</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_is_remote_error" c:identifier="g_dbus_error_is_remote_error" moved-to="DBusError.is_remote_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16419">Checks if @error represents an error received via D-Bus from a remote peer. If so,
|
|
use g_dbus_error_get_remote_error() to get the name of the error.</doc>
|
|
<source-position filename="gdbuserror.h" line="53"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16426">%TRUE if @error represents an error from a remote peer,
|
|
%FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16421">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_new_for_dbus_error" c:identifier="g_dbus_error_new_for_dbus_error" moved-to="DBusError.new_for_dbus_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16432">Creates a #GError based on the contents of @dbus_error_name and
|
|
@dbus_error_message.
|
|
|
|
Errors registered with g_dbus_error_register_error() will be looked
|
|
up using @dbus_error_name and if a match is found, the error domain
|
|
and code is used. Applications can use g_dbus_error_get_remote_error()
|
|
to recover @dbus_error_name.
|
|
|
|
If a match against a registered error is not found and the D-Bus
|
|
error name is in a form as returned by g_dbus_error_encode_gerror()
|
|
the error domain and code encoded in the name is used to
|
|
create the #GError. Also, @dbus_error_name is added to the error message
|
|
such that it can be recovered with g_dbus_error_get_remote_error().
|
|
|
|
Otherwise, a #GError with the error code %G_IO_ERROR_DBUS_ERROR
|
|
in the #G_IO_ERROR error domain is returned. Also, @dbus_error_name is
|
|
added to the error message such that it can be recovered with
|
|
g_dbus_error_get_remote_error().
|
|
|
|
In all three cases, @dbus_error_name can always be recovered from the
|
|
returned #GError using the g_dbus_error_get_remote_error() function
|
|
(unless g_dbus_error_strip_remote_error() hasn't been used on the returned error).
|
|
|
|
This function is typically only used in object mappings to prepare
|
|
#GError instances for applications. Regular applications should not use
|
|
it.</doc>
|
|
<source-position filename="gdbuserror.h" line="90"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16464">An allocated #GError. Free with g_error_free().</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16434">D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_message" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16435">D-Bus error message.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_quark" c:identifier="g_dbus_error_quark" moved-to="DBusError.quark">
|
|
<return-value transfer-ownership="none">
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="dbus_error_register_error" c:identifier="g_dbus_error_register_error" moved-to="DBusError.register_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16469">Creates an association to map between @dbus_error_name and
|
|
#GErrors specified by @error_domain and @error_code.
|
|
|
|
This is typically done in the routine that returns the #GQuark for
|
|
an error domain.</doc>
|
|
<source-position filename="gdbuserror.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16481">%TRUE if the association was created, %FALSE if it already
|
|
exists.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error_domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16471">A #GQuark for a error domain.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="error_code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16472">An error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16473">A D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_register_error_domain" c:identifier="g_dbus_error_register_error_domain" moved-to="DBusError.register_error_domain" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16487">Helper function for associating a #GError error domain with D-Bus error names.</doc>
|
|
<source-position filename="gdbuserror.h" line="83"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error_domain_quark_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16489">The error domain name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="quark_volatile" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16490">A pointer where to store the #GQuark.</doc>
|
|
<type name="gsize" c:type="volatile gsize*"/>
|
|
</parameter>
|
|
<parameter name="entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16491">A pointer to @num_entries #GDBusErrorEntry struct items.</doc>
|
|
<array length="3" zero-terminated="0" c:type="const GDBusErrorEntry*">
|
|
<type name="DBusErrorEntry" c:type="GDBusErrorEntry"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="num_entries" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16492">Number of items to register.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_strip_remote_error" c:identifier="g_dbus_error_strip_remote_error" moved-to="DBusError.strip_remote_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16530">Looks for extra information in the error message used to recover
|
|
the D-Bus error name and strips it if found. If stripped, the
|
|
message field in @error will correspond exactly to what was
|
|
received on the wire.
|
|
|
|
This is typically used when presenting errors to the end user.</doc>
|
|
<source-position filename="gdbuserror.h" line="57"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16541">%TRUE if information was stripped, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16532">A #GError.</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_error_unregister_error" c:identifier="g_dbus_error_unregister_error" moved-to="DBusError.unregister_error" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16546">Destroys an association previously set up with g_dbus_error_register_error().</doc>
|
|
<source-position filename="gdbuserror.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16554">%TRUE if the association was destroyed, %FALSE if it wasn't found.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="error_domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16548">A #GQuark for a error domain.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="error_code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16549">An error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="dbus_error_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16550">A D-Bus error name.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_generate_guid" c:identifier="g_dbus_generate_guid" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16559">Generate a D-Bus GUID that can be used with
|
|
e.g. g_dbus_connection_new().
|
|
|
|
See the D-Bus specification regarding what strings are valid D-Bus
|
|
GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</doc>
|
|
<source-position filename="gdbusutils.h" line="35"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16568">A valid D-Bus GUID. Free with g_free().</doc>
|
|
<type name="utf8" c:type="gchar*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="dbus_gvalue_to_gvariant" c:identifier="g_dbus_gvalue_to_gvariant" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16573">Converts a #GValue to a #GVariant of the type indicated by the @type
|
|
parameter.
|
|
|
|
The conversion is using the following rules:
|
|
|
|
- #G_TYPE_STRING: 's', 'o', 'g' or 'ay'
|
|
- #G_TYPE_STRV: 'as', 'ao' or 'aay'
|
|
- #G_TYPE_BOOLEAN: 'b'
|
|
- #G_TYPE_UCHAR: 'y'
|
|
- #G_TYPE_INT: 'i', 'n'
|
|
- #G_TYPE_UINT: 'u', 'q'
|
|
- #G_TYPE_INT64 'x'
|
|
- #G_TYPE_UINT64: 't'
|
|
- #G_TYPE_DOUBLE: 'd'
|
|
- #G_TYPE_VARIANT: Any #GVariantType
|
|
|
|
This can fail if e.g. @gvalue is of type #G_TYPE_STRING and @type
|
|
is ['i'][G-VARIANT-TYPE-INT32:CAPS]. It will also fail for any #GType
|
|
(including e.g. #G_TYPE_OBJECT and #G_TYPE_BOXED derived-types) not
|
|
in the table above.
|
|
|
|
Note that if @gvalue is of type #G_TYPE_VARIANT and its value is
|
|
%NULL, the empty #GVariant instance (never %NULL) for @type is
|
|
returned (e.g. 0 for scalar types, the empty string for string types,
|
|
'/' for object path types, the empty array for any array type and so on).
|
|
|
|
See the g_dbus_gvariant_to_gvalue() function for how to convert a
|
|
#GVariant to a #GValue.</doc>
|
|
<source-position filename="gdbusutils.h" line="50"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16607">A #GVariant (never floating) of #GVariantType @type holding
|
|
the data from @gvalue or %NULL in case of failure. Free with
|
|
g_variant_unref().</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="gvalue" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16575">A #GValue to convert to a #GVariant</doc>
|
|
<type name="GObject.Value" c:type="const GValue*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16576">A #GVariantType</doc>
|
|
<type name="GLib.VariantType" c:type="const GVariantType*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_gvariant_to_gvalue" c:identifier="g_dbus_gvariant_to_gvalue" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16614">Converts a #GVariant to a #GValue. If @value is floating, it is consumed.
|
|
|
|
The rules specified in the g_dbus_gvalue_to_gvariant() function are
|
|
used - this function is essentially its reverse form. So, a #GVariant
|
|
containing any basic or string array type will be converted to a #GValue
|
|
containing a basic value or string array. Any other #GVariant (handle,
|
|
variant, tuple, dict entry) will be converted to a #GValue containing that
|
|
#GVariant.
|
|
|
|
The conversion never fails - a valid #GValue is always returned in
|
|
@out_gvalue.</doc>
|
|
<source-position filename="gdbusutils.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16616">A #GVariant.</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
<parameter name="out_gvalue" direction="out" caller-allocates="1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16617">Return location pointing to a zero-filled (uninitialized) #GValue.</doc>
|
|
<type name="GObject.Value" c:type="GValue*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_is_address" c:identifier="g_dbus_is_address" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16981">Checks if @string is a
|
|
[D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
|
|
|
|
This doesn't check if @string is actually supported by #GDBusServer
|
|
or #GDBusConnection - use g_dbus_is_supported_address() to do more
|
|
checks.</doc>
|
|
<source-position filename="gdbusaddress.h" line="36"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16992">%TRUE if @string is a valid D-Bus address, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16983">A string.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_is_guid" c:identifier="g_dbus_is_guid" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16997">Checks if @string is a D-Bus GUID.
|
|
|
|
See the D-Bus specification regarding what strings are valid D-Bus
|
|
GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).</doc>
|
|
<source-position filename="gdbusutils.h" line="33"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17006">%TRUE if @string is a guid, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="16999">The string to check.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_is_interface_name" c:identifier="g_dbus_is_interface_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17011">Checks if @string is a valid D-Bus interface name.</doc>
|
|
<source-position filename="gdbusutils.h" line="44"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17017">%TRUE if valid, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17013">The string to check.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_is_member_name" c:identifier="g_dbus_is_member_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17022">Checks if @string is a valid D-Bus member (e.g. signal or method) name.</doc>
|
|
<source-position filename="gdbusutils.h" line="42"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17028">%TRUE if valid, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17024">The string to check.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_is_name" c:identifier="g_dbus_is_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17033">Checks if @string is a valid D-Bus bus name (either unique or well-known).</doc>
|
|
<source-position filename="gdbusutils.h" line="38"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17039">%TRUE if valid, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17035">The string to check.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_is_supported_address" c:identifier="g_dbus_is_supported_address" version="2.26" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17044">Like g_dbus_is_address() but also checks if the library supports the
|
|
transports in @string and that key/value pairs for each transport
|
|
are valid. See the specification of the
|
|
[D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).</doc>
|
|
<source-position filename="gdbusaddress.h" line="38"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17054">%TRUE if @string is a valid D-Bus address that is
|
|
supported by this library, %FALSE if @error is set.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17046">A string.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dbus_is_unique_name" c:identifier="g_dbus_is_unique_name" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17060">Checks if @string is a valid D-Bus unique bus name.</doc>
|
|
<source-position filename="gdbusutils.h" line="40"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17066">%TRUE if valid, %FALSE otherwise.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="string" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="17062">The string to check.</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dtls_client_connection_new" c:identifier="g_dtls_client_connection_new" moved-to="DtlsClientConnection.new" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20152">Creates a new #GDtlsClientConnection wrapping @base_socket which is
|
|
assumed to communicate with the server identified by @server_identity.</doc>
|
|
<source-position filename="gdtlsclientconnection.h" line="55"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20161">the new
|
|
#GDtlsClientConnection, or %NULL on error</doc>
|
|
<type name="DtlsClientConnection" c:type="GDatagramBased*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20154">the #GDatagramBased to wrap</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="server_identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20155">the expected identity of the server</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="dtls_server_connection_new" c:identifier="g_dtls_server_connection_new" moved-to="DtlsServerConnection.new" version="2.48" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20659">Creates a new #GDtlsServerConnection wrapping @base_socket.</doc>
|
|
<source-position filename="gdtlsserverconnection.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20667">the new
|
|
#GDtlsServerConnection, or %NULL on error</doc>
|
|
<type name="DtlsServerConnection" c:type="GDatagramBased*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_socket" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20661">the #GDatagramBased to wrap</doc>
|
|
<type name="DatagramBased" c:type="GDatagramBased*"/>
|
|
</parameter>
|
|
<parameter name="certificate" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="20662">the default server certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="file_new_for_commandline_arg" c:identifier="g_file_new_for_commandline_arg" moved-to="File.new_for_commandline_arg">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23672">Creates a #GFile with the given argument from the command line.
|
|
The value of @arg can be either a URI, an absolute path or a
|
|
relative path resolved relative to the current working directory.
|
|
This operation never fails, but the returned object might not
|
|
support any I/O operation if @arg points to a malformed path.
|
|
|
|
Note that on Windows, this function expects its argument to be in
|
|
UTF-8 -- not the system code page. This means that you
|
|
should not use this function with string from argv as it is passed
|
|
to main(). g_win32_get_command_line() will return a UTF-8 version of
|
|
the commandline. #GApplication also uses UTF-8 but
|
|
g_application_command_line_create_file_for_arg() may be more useful
|
|
for you there. It is also always possible to use this function with
|
|
#GOptionContext arguments of type %G_OPTION_ARG_FILENAME.</doc>
|
|
<source-position filename="gfile.h" line="599"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23691">a new #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="arg" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23674">a command line string</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="file_new_for_commandline_arg_and_cwd" c:identifier="g_file_new_for_commandline_arg_and_cwd" moved-to="File.new_for_commandline_arg_and_cwd" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23696">Creates a #GFile with the given argument from the command line.
|
|
|
|
This function is similar to g_file_new_for_commandline_arg() except
|
|
that it allows for passing the current working directory as an
|
|
argument instead of using the current working directory of the
|
|
process.
|
|
|
|
This is useful if the commandline argument was given in a context
|
|
other than the invocation of the current process.
|
|
|
|
See also g_application_command_line_create_file_for_arg().</doc>
|
|
<source-position filename="gfile.h" line="601"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23713">a new #GFile</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="arg" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23698">a command line string</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="cwd" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23699">the current working directory of the commandline</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="file_new_for_path" c:identifier="g_file_new_for_path" moved-to="File.new_for_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23718">Constructs a #GFile for a given path. This operation never
|
|
fails, but the returned object might not support any I/O
|
|
operation if @path is malformed.</doc>
|
|
<source-position filename="gfile.h" line="595"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23727">a new #GFile for the given @path.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23720">a string containing a relative or absolute path.
|
|
The string must be encoded in the glib filename encoding.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="file_new_for_uri" c:identifier="g_file_new_for_uri" moved-to="File.new_for_uri">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23732">Constructs a #GFile for a given URI. This operation never
|
|
fails, but the returned object might not support any I/O
|
|
operation if @uri is malformed or if the uri type is
|
|
not supported.</doc>
|
|
<source-position filename="gfile.h" line="597"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23741">a new #GFile for the given @uri.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="uri" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23734">a UTF-8 string containing a URI</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="file_new_tmp" c:identifier="g_file_new_tmp" moved-to="File.new_tmp" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23746">Opens a file in the preferred directory for temporary files (as
|
|
returned by g_get_tmp_dir()) and returns a #GFile and
|
|
#GFileIOStream pointing to it.
|
|
|
|
@tmpl should be a string in the GLib file name encoding
|
|
containing a sequence of six 'X' characters, and containing no
|
|
directory components. If it is %NULL, a default template is used.
|
|
|
|
Unlike the other #GFile constructors, this will return %NULL if
|
|
a temporary file could not be created.</doc>
|
|
<source-position filename="gfile.h" line="604"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23764">a new #GFile.
|
|
Free the returned object with g_object_unref().</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="tmpl" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23748">Template for the file
|
|
name, as in g_file_open_tmp(), or %NULL for a default template</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="iostream" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23750">on return, a #GFileIOStream for the created file</doc>
|
|
<type name="FileIOStream" c:type="GFileIOStream**"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="file_parse_name" c:identifier="g_file_parse_name" moved-to="File.parse_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23909">Constructs a #GFile with the given @parse_name (i.e. something
|
|
given by g_file_get_parse_name()). This operation never fails,
|
|
but the returned object might not support any I/O operation if
|
|
the @parse_name cannot be parsed.</doc>
|
|
<source-position filename="gfile.h" line="608"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23918">a new #GFile.</doc>
|
|
<type name="File" c:type="GFile*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="parse_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="23911">a file name or path to be parsed</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="icon_deserialize" c:identifier="g_icon_deserialize" moved-to="Icon.deserialize" version="2.38">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25265">Deserializes a #GIcon previously serialized using g_icon_serialize().</doc>
|
|
<source-position filename="gicon.h" line="98"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25271">a #GIcon, or %NULL when deserialization fails.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="value" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25267">a #GVariant created with g_icon_serialize()</doc>
|
|
<type name="GLib.Variant" c:type="GVariant*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="icon_hash" c:identifier="g_icon_hash" moved-to="Icon.hash">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25287">Gets a hash for an icon.</doc>
|
|
<source-position filename="gicon.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25293">a #guint containing a hash for the @icon, suitable for
|
|
use in a #GHashTable or similar data structure.</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="icon" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25289">#gconstpointer to an icon object.</doc>
|
|
<type name="gpointer" c:type="gconstpointer"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="icon_new_for_string" c:identifier="g_icon_new_for_string" moved-to="Icon.new_for_string" version="2.20" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25298">Generate a #GIcon instance from @str. This function can fail if
|
|
@str is not valid - see g_icon_to_string() for discussion.
|
|
|
|
If your application or library provides one or more #GIcon
|
|
implementations you need to ensure that each #GType is registered
|
|
with the type system prior to calling g_icon_new_for_string().</doc>
|
|
<source-position filename="gicon.h" line="92"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25310">An object implementing the #GIcon
|
|
interface or %NULL if @error is set.</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="str" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25300">A string obtained via g_icon_to_string().</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="initable_newv" c:identifier="g_initable_newv" moved-to="Initable.newv" version="2.22" deprecated="1" deprecated-version="2.54" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25855">Helper function for constructing #GInitable object. This is
|
|
similar to g_object_newv() but also initializes the object
|
|
and returns %NULL, setting an error on failure.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_object_new_with_properties() and
|
|
g_initable_init() instead. See #GParameter for more information.</doc-deprecated>
|
|
<source-position filename="ginitable.h" line="87"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25868">a newly allocated
|
|
#GObject, or %NULL on error</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25857">a #GType supporting #GInitable.</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="n_parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25858">the number of parameters in @parameters</doc>
|
|
<type name="guint" c:type="guint"/>
|
|
</parameter>
|
|
<parameter name="parameters" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25859">the parameters to use to construct the object</doc>
|
|
<array length="1" zero-terminated="0" c:type="GParameter*">
|
|
<type name="GObject.Parameter" c:type="GParameter"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="25860">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_error_from_errno" c:identifier="g_io_error_from_errno">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26313">Converts errno.h error codes into GIO error codes. The fallback
|
|
value %G_IO_ERROR_FAILED is returned for error codes not currently
|
|
handled (but note that future GLib releases may return a more
|
|
specific value instead).
|
|
|
|
As %errno is global and may be modified by intermediate function
|
|
calls, you should save its value as soon as the call which sets it</doc>
|
|
<source-position filename="gioerror.h" line="44"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26325">#GIOErrorEnum value for the given errno.h error number.</doc>
|
|
<type name="IOErrorEnum" c:type="GIOErrorEnum"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="err_no" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26315">Error number as defined in errno.h.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_error_quark" c:identifier="g_io_error_quark">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26348">Gets the GIO Error Quark.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26353">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="io_extension_point_implement" c:identifier="g_io_extension_point_implement" moved-to="IOExtensionPoint.implement">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26426">Registers @type as extension for the extension point with name
|
|
@extension_point_name.
|
|
|
|
If @type has already been registered as an extension for this
|
|
extension point, the existing #GIOExtension object is returned.</doc>
|
|
<source-position filename="giomodule.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26439">a #GIOExtension object for #GType</doc>
|
|
<type name="IOExtension" c:type="GIOExtension*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="extension_point_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26428">the name of the extension point</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26429">the #GType to register as extension</doc>
|
|
<type name="GType" c:type="GType"/>
|
|
</parameter>
|
|
<parameter name="extension_name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26430">the name for the extension</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26431">the priority for the extension</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_extension_point_lookup" c:identifier="g_io_extension_point_lookup" moved-to="IOExtensionPoint.lookup">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26443">Looks up an existing extension point.</doc>
|
|
<source-position filename="giomodule.h" line="77"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26449">the #GIOExtensionPoint, or %NULL if there
|
|
is no registered extension point with the given name.</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26445">the name of the extension point</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_extension_point_register" c:identifier="g_io_extension_point_register" moved-to="IOExtensionPoint.register">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26454">Registers an extension point.</doc>
|
|
<source-position filename="giomodule.h" line="75"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26460">the new #GIOExtensionPoint. This object is
|
|
owned by GIO and should not be freed.</doc>
|
|
<type name="IOExtensionPoint" c:type="GIOExtensionPoint*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="name" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26456">The name of the extension point</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_modules_load_all_in_directory" c:identifier="g_io_modules_load_all_in_directory">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26537">Loads all the modules in the specified directory.
|
|
|
|
If don't require all modules to be initialized (and thus registering
|
|
all gtypes) then you can use g_io_modules_scan_all_in_directory()
|
|
which allows delayed/lazy loading of modules.</doc>
|
|
<source-position filename="giomodule.h" line="65"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26548">a list of #GIOModules loaded
|
|
from the directory,
|
|
All the modules are loaded into memory, if you want to
|
|
unload them (enabling on-demand loading) you must call
|
|
g_type_module_unuse() on all the modules. Free the list
|
|
with g_list_free().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="IOModule"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="dirname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26539">pathname for a directory containing modules
|
|
to load.</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_modules_load_all_in_directory_with_scope" c:identifier="g_io_modules_load_all_in_directory_with_scope" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26557">Loads all the modules in the specified directory.
|
|
|
|
If don't require all modules to be initialized (and thus registering
|
|
all gtypes) then you can use g_io_modules_scan_all_in_directory()
|
|
which allows delayed/lazy loading of modules.</doc>
|
|
<source-position filename="giomodule.h" line="71"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26569">a list of #GIOModules loaded
|
|
from the directory,
|
|
All the modules are loaded into memory, if you want to
|
|
unload them (enabling on-demand loading) you must call
|
|
g_type_module_unuse() on all the modules. Free the list
|
|
with g_list_free().</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="IOModule"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="dirname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26559">pathname for a directory containing modules
|
|
to load.</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="scope" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26561">a scope to use when scanning the modules.</doc>
|
|
<type name="IOModuleScope" c:type="GIOModuleScope*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_modules_scan_all_in_directory" c:identifier="g_io_modules_scan_all_in_directory" version="2.24">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26579">Scans all the modules in the specified directory, ensuring that
|
|
any extension point implemented by a module is registered.
|
|
|
|
This may not actually load and initialize all the types in each
|
|
module, some modules may be lazily loaded and initialized when
|
|
an extension point it implementes is used with e.g.
|
|
g_io_extension_point_get_extensions() or
|
|
g_io_extension_point_get_extension_by_name().
|
|
|
|
If you need to guarantee that all types are loaded in all the modules,
|
|
use g_io_modules_load_all_in_directory().</doc>
|
|
<source-position filename="giomodule.h" line="63"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="dirname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26581">pathname for a directory containing modules
|
|
to scan.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_modules_scan_all_in_directory_with_scope" c:identifier="g_io_modules_scan_all_in_directory_with_scope" version="2.30">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26600">Scans all the modules in the specified directory, ensuring that
|
|
any extension point implemented by a module is registered.
|
|
|
|
This may not actually load and initialize all the types in each
|
|
module, some modules may be lazily loaded and initialized when
|
|
an extension point it implementes is used with e.g.
|
|
g_io_extension_point_get_extensions() or
|
|
g_io_extension_point_get_extension_by_name().
|
|
|
|
If you need to guarantee that all types are loaded in all the modules,
|
|
use g_io_modules_load_all_in_directory().</doc>
|
|
<source-position filename="giomodule.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="dirname" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26602">pathname for a directory containing modules
|
|
to scan.</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="scope" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26604">a scope to use when scanning the modules</doc>
|
|
<type name="IOModuleScope" c:type="GIOModuleScope*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="io_scheduler_cancel_all_jobs" c:identifier="g_io_scheduler_cancel_all_jobs" deprecated="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26622">Cancels all cancellable I/O jobs.
|
|
|
|
A job is cancellable if a #GCancellable was passed into
|
|
g_io_scheduler_push_job().</doc>
|
|
<doc-deprecated xml:space="preserve">You should never call this function, since you don't
|
|
know how other libraries in your program might be making use of
|
|
gioscheduler.</doc-deprecated>
|
|
<source-position filename="gioscheduler.h" line="40"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="io_scheduler_push_job" c:identifier="g_io_scheduler_push_job" deprecated="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26673">Schedules the I/O job to run in another thread.
|
|
|
|
@notify will be called on @user_data after @job_func has returned,
|
|
regardless whether the job was cancelled or has run to completion.
|
|
|
|
If @cancellable is not %NULL, it can be used to cancel the I/O job
|
|
by calling g_cancellable_cancel() or by calling
|
|
g_io_scheduler_cancel_all_jobs().</doc>
|
|
<doc-deprecated xml:space="preserve">use #GThreadPool or g_task_run_in_thread()</doc-deprecated>
|
|
<source-position filename="gioscheduler.h" line="34"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="job_func" transfer-ownership="none" scope="notified" closure="1" destroy="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26675">a #GIOSchedulerJobFunc.</doc>
|
|
<type name="IOSchedulerJobFunc" c:type="GIOSchedulerJobFunc"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26676">data to pass to @job_func</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="notify" transfer-ownership="none" nullable="1" allow-none="1" scope="async">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26677">a #GDestroyNotify for @user_data, or %NULL</doc>
|
|
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
|
|
</parameter>
|
|
<parameter name="io_priority" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26678">the [I/O priority][io-priority]
|
|
of the request.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26680">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="keyfile_settings_backend_new" c:identifier="g_keyfile_settings_backend_new">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26885">Creates a keyfile-backed #GSettingsBackend.
|
|
|
|
The filename of the keyfile to use is given by @filename.
|
|
|
|
All settings read to or written from the backend must fall under the
|
|
path given in @root_path (which must start and end with a slash and
|
|
not contain two consecutive slashes). @root_path may be "/".
|
|
|
|
If @root_group is non-%NULL then it specifies the name of the keyfile
|
|
group used for keys that are written directly below @root_path. For
|
|
example, if @root_path is "/apps/example/" and @root_group is
|
|
"toplevel", then settings the key "/apps/example/enabled" to a value
|
|
of %TRUE will cause the following to appear in the keyfile:
|
|
|
|
|[
|
|
[toplevel]
|
|
enabled=true
|
|
]|
|
|
|
|
If @root_group is %NULL then it is not permitted to store keys
|
|
directly below the @root_path.
|
|
|
|
For keys not stored directly below @root_path (ie: in a sub-path),
|
|
the name of the subpath (with the final slash stripped) is used as
|
|
the name of the keyfile group. To continue the example, if
|
|
"/apps/example/profiles/default/font-size" were set to
|
|
12 then the following would appear in the keyfile:
|
|
|
|
|[
|
|
[profiles/default]
|
|
font-size=12
|
|
]|
|
|
|
|
The backend will refuse writes (and return writability as being
|
|
%FALSE) for keys outside of @root_path and, in the event that
|
|
@root_group is %NULL, also for keys directly under @root_path.
|
|
Writes will also be refused if the backend detects that it has the
|
|
inability to rewrite the keyfile (ie: the containing directory is not
|
|
writable).
|
|
|
|
There is no checking done for your key namespace clashing with the
|
|
syntax of the key file format. For example, if you have '[' or ']'
|
|
characters in your path names or '=' in your key names you may be in
|
|
trouble.
|
|
|
|
The backend reads default values from a keyfile called `defaults` in
|
|
the directory specified by the #GKeyfileSettingsBackend:defaults-dir property,
|
|
and a list of locked keys from a text file with the name `locks` in
|
|
the same location.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="162"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26942">a keyfile-backed #GSettingsBackend</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26887">the filename of the keyfile</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="root_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26888">the path under which all settings keys appear</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
<parameter name="root_group" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="26889">the group name corresponding to
|
|
@root_path, or %NULL</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="memory_settings_backend_new" c:identifier="g_memory_settings_backend_new" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27427">Creates a memory-backed #GSettingsBackend.
|
|
|
|
This backend allows changes to settings, but does not write them
|
|
to any backing storage, so the next time you run your application,
|
|
the memory backend will start out with the default values again.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="170"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="27436">a newly created #GSettingsBackend</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="network_monitor_get_default" c:identifier="g_network_monitor_get_default" moved-to="NetworkMonitor.get_default" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29304">Gets the default #GNetworkMonitor for the system.</doc>
|
|
<source-position filename="gnetworkmonitor.h" line="70"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29309">a #GNetworkMonitor</doc>
|
|
<type name="NetworkMonitor" c:type="GNetworkMonitor*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="networking_init" c:identifier="g_networking_init" version="2.36">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29413">Initializes the platform networking libraries (eg, on Windows, this
|
|
calls WSAStartup()). GLib will call this itself if it is needed, so
|
|
you only need to call it if you directly call system networking
|
|
functions (without calling any GLib networking functions first).</doc>
|
|
<source-position filename="gnetworking.h" line="78"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="null_settings_backend_new" c:identifier="g_null_settings_backend_new" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29617">Creates a readonly #GSettingsBackend.
|
|
|
|
This backend does not allow changes to settings, so all settings
|
|
will always have their default values.</doc>
|
|
<source-position filename="gsettingsbackend.h" line="167"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="29625">a newly created #GSettingsBackend</doc>
|
|
<type name="SettingsBackend" c:type="GSettingsBackend*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="pollable_source_new" c:identifier="g_pollable_source_new" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30736">Utility method for #GPollableInputStream and #GPollableOutputStream
|
|
implementations. Creates a new #GSource that expects a callback of
|
|
type #GPollableSourceFunc. The new source does not actually do
|
|
anything on its own; use g_source_add_child_source() to add other
|
|
sources to it to cause it to trigger.</doc>
|
|
<source-position filename="gpollableutils.h" line="31"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30746">the new #GSource.</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pollable_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30738">the stream associated with the new source</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="pollable_source_new_full" c:identifier="g_pollable_source_new_full" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30751">Utility method for #GPollableInputStream and #GPollableOutputStream
|
|
implementations. Creates a new #GSource, as with
|
|
g_pollable_source_new(), but also attaching @child_source (with a
|
|
dummy callback), and @cancellable, if they are non-%NULL.</doc>
|
|
<source-position filename="gpollableutils.h" line="34"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30763">the new #GSource.</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="pollable_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30753">the stream associated with the
|
|
new source</doc>
|
|
<type name="GObject.Object" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="child_source" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30755">optional child source to attach</doc>
|
|
<type name="GLib.Source" c:type="GSource*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30756">optional #GCancellable to attach</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="pollable_stream_read" c:identifier="g_pollable_stream_read" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30768">Tries to read from @stream, as with g_input_stream_read() (if
|
|
@blocking is %TRUE) or g_pollable_input_stream_read_nonblocking()
|
|
(if @blocking is %FALSE). This can be used to more easily share
|
|
code between blocking and non-blocking implementations of a method.
|
|
|
|
If @blocking is %FALSE, then @stream must be a
|
|
#GPollableInputStream for which g_pollable_input_stream_can_poll()
|
|
returns %TRUE, or else the behavior is undefined. If @blocking is
|
|
%TRUE, then @stream does not need to be a #GPollableInputStream.</doc>
|
|
<source-position filename="gpollableutils.h" line="39"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30788">the number of bytes read, or -1 on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30770">a #GInputStream</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30771">a buffer to
|
|
read data into</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30773">the number of bytes to read</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="blocking" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30774">whether to do blocking I/O</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30775">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="pollable_stream_write" c:identifier="g_pollable_stream_write" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30793">Tries to write to @stream, as with g_output_stream_write() (if
|
|
@blocking is %TRUE) or g_pollable_output_stream_write_nonblocking()
|
|
(if @blocking is %FALSE). This can be used to more easily share
|
|
code between blocking and non-blocking implementations of a method.
|
|
|
|
If @blocking is %FALSE, then @stream must be a
|
|
#GPollableOutputStream for which
|
|
g_pollable_output_stream_can_poll() returns %TRUE or else the
|
|
behavior is undefined. If @blocking is %TRUE, then @stream does not
|
|
need to be a #GPollableOutputStream.</doc>
|
|
<source-position filename="gpollableutils.h" line="47"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30814">the number of bytes written, or -1 on error.</doc>
|
|
<type name="gssize" c:type="gssize"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30795">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30796">the buffer
|
|
containing the data to write.</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30798">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="blocking" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30799">whether to do blocking I/O</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30800">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="pollable_stream_write_all" c:identifier="g_pollable_stream_write_all" version="2.34" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30819">Tries to write @count bytes to @stream, as with
|
|
g_output_stream_write_all(), but using g_pollable_stream_write()
|
|
rather than g_output_stream_write().
|
|
|
|
On a successful write of @count bytes, %TRUE is returned, and
|
|
@bytes_written is set to @count.
|
|
|
|
If there is an error during the operation (including
|
|
%G_IO_ERROR_WOULD_BLOCK in the non-blocking case), %FALSE is
|
|
returned and @error is set to indicate the error status,
|
|
@bytes_written is updated to contain the number of bytes written
|
|
into the stream before the error occurred.
|
|
|
|
As with g_pollable_stream_write(), if @blocking is %FALSE, then
|
|
@stream must be a #GPollableOutputStream for which
|
|
g_pollable_output_stream_can_poll() returns %TRUE or else the
|
|
behavior is undefined. If @blocking is %TRUE, then @stream does not
|
|
need to be a #GPollableOutputStream.</doc>
|
|
<source-position filename="gpollableutils.h" line="54"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30850">%TRUE on success, %FALSE if there was an error</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30821">a #GOutputStream.</doc>
|
|
<type name="OutputStream" c:type="GOutputStream*"/>
|
|
</parameter>
|
|
<parameter name="buffer" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30822">the buffer
|
|
containing the data to write.</doc>
|
|
<array length="2" zero-terminated="0" c:type="void*">
|
|
<type name="guint8"/>
|
|
</array>
|
|
</parameter>
|
|
<parameter name="count" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30824">the number of bytes to write</doc>
|
|
<type name="gsize" c:type="gsize"/>
|
|
</parameter>
|
|
<parameter name="blocking" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30825">whether to do blocking I/O</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</parameter>
|
|
<parameter name="bytes_written" direction="out" caller-allocates="0" transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30826">location to store the number of bytes that was
|
|
written to the stream</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="cancellable" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="30828">optional #GCancellable object, %NULL to ignore.</doc>
|
|
<type name="Cancellable" c:type="GCancellable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="proxy_get_default_for_protocol" c:identifier="g_proxy_get_default_for_protocol" moved-to="Proxy.get_default_for_protocol" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31030">Find the `gio-proxy` extension point for a proxy implementation that supports
|
|
the specified protocol.</doc>
|
|
<source-position filename="gproxy.h" line="101"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31037">return a #GProxy or NULL if protocol
|
|
is not supported.</doc>
|
|
<type name="Proxy" c:type="GProxy*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="protocol" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31032">the proxy protocol name (e.g. http, socks, etc)</doc>
|
|
<type name="utf8" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="proxy_resolver_get_default" c:identifier="g_proxy_resolver_get_default" moved-to="ProxyResolver.get_default" version="2.26">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31043">Gets the default #GProxyResolver for the system.</doc>
|
|
<source-position filename="gproxyresolver.h" line="72"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31048">the default #GProxyResolver.</doc>
|
|
<type name="ProxyResolver" c:type="GProxyResolver*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="resolver_error_quark" c:identifier="g_resolver_error_quark" moved-to="ResolverError.quark" version="2.22">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31187">Gets the #GResolver Error Quark.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31192">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="resource_error_quark" c:identifier="g_resource_error_quark" moved-to="ResourceError.quark" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31613">Gets the #GResource Error Quark.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31618">a #GQuark</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="resource_load" c:identifier="g_resource_load" moved-to="Resource.load" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31644">Loads a binary resource bundle and creates a #GResource representation of it, allowing
|
|
you to query it for data.
|
|
|
|
If you want to use this resource in the global resource namespace you need
|
|
to register it with g_resources_register().
|
|
|
|
If @filename is empty or the data in it is corrupt,
|
|
%G_RESOURCE_ERROR_INTERNAL will be returned. If @filename doesn’t exist, or
|
|
there is an error in reading it, an error from g_mapped_file_new() will be
|
|
returned.</doc>
|
|
<source-position filename="gresource.h" line="72"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31660">a new #GResource, or %NULL on error</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="filename" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31646">the path of a filename to load, in the GLib filename encoding</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="resources_enumerate_children" c:identifier="g_resources_enumerate_children" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31759">Returns all the names of children at the specified @path in the set of
|
|
globally registered resources.
|
|
The return result is a %NULL terminated list of strings which should
|
|
be released with g_strfreev().
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="110"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31772">an array of constant strings</doc>
|
|
<array c:type="char**">
|
|
<type name="utf8"/>
|
|
</array>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31761">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31762">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="resources_get_info" c:identifier="g_resources_get_info" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31777">Looks for a file at the specified @path in the set of
|
|
globally registered resources and if found returns information about it.
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="114"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31792">%TRUE if the file was found. %FALSE if there were errors</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31779">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31780">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
<parameter name="size" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31781">a location to place the length of the contents of the file,
|
|
or %NULL if the length is not needed</doc>
|
|
<type name="gsize" c:type="gsize*"/>
|
|
</parameter>
|
|
<parameter name="flags" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31783">a location to place the #GResourceFlags about the file,
|
|
or %NULL if the flags are not needed</doc>
|
|
<type name="guint32" c:type="guint32*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="resources_lookup_data" c:identifier="g_resources_lookup_data" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31797">Looks for a file at the specified @path in the set of
|
|
globally registered resources and returns a #GBytes that
|
|
lets you directly access the data in memory.
|
|
|
|
The data is always followed by a zero byte, so you
|
|
can safely use the data as a C string. However, that byte
|
|
is not included in the size of the GBytes.
|
|
|
|
For uncompressed resource files this is a pointer directly into
|
|
the resource bundle, which is typically in some readonly data section
|
|
in the program binary. For compressed files we allocate memory on
|
|
the heap and automatically uncompress the data.
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="106"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31818">#GBytes or %NULL on error.
|
|
Free the returned object with g_bytes_unref()</doc>
|
|
<type name="GLib.Bytes" c:type="GBytes*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31799">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31800">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="resources_open_stream" c:identifier="g_resources_open_stream" version="2.32" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31824">Looks for a file at the specified @path in the set of
|
|
globally registered resources and returns a #GInputStream
|
|
that lets you read the data.
|
|
|
|
@lookup_flags controls the behaviour of the lookup.</doc>
|
|
<source-position filename="gresource.h" line="102"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31836">#GInputStream or %NULL on error.
|
|
Free the returned object with g_object_unref()</doc>
|
|
<type name="InputStream" c:type="GInputStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31826">A pathname inside the resource</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="lookup_flags" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31827">A #GResourceLookupFlags</doc>
|
|
<type name="ResourceLookupFlags" c:type="GResourceLookupFlags"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="resources_register" c:identifier="g_resources_register" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31842">Registers the resource with the process-global set of resources.
|
|
Once a resource is registered the files in it can be accessed
|
|
with the global resource lookup functions like g_resources_lookup_data().</doc>
|
|
<source-position filename="gresource.h" line="98"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31844">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="resources_unregister" c:identifier="g_resources_unregister" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31854">Unregisters the resource from the process-global set of resources.</doc>
|
|
<source-position filename="gresource.h" line="100"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="resource" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="31856">A #GResource</doc>
|
|
<type name="Resource" c:type="GResource*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="settings_schema_source_get_default" c:identifier="g_settings_schema_source_get_default" moved-to="SettingsSchemaSource.get_default" version="2.32">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33124">Gets the default system schema source.
|
|
|
|
This function is not required for normal uses of #GSettings but it
|
|
may be useful to authors of plugin management systems or to those who
|
|
want to introspect the content of schemas.
|
|
|
|
If no schemas are installed, %NULL will be returned.
|
|
|
|
The returned source may actually consist of multiple schema sources
|
|
from different directories, depending on which directories were given
|
|
in `XDG_DATA_DIRS` and `GSETTINGS_SCHEMA_DIR`. For this reason, all
|
|
lookups performed against the default source should probably be done
|
|
recursively.</doc>
|
|
<source-position filename="gsettingsschema.h" line="35"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33141">the default schema source</doc>
|
|
<type name="SettingsSchemaSource" c:type="GSettingsSchemaSource*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="simple_async_report_error_in_idle" c:identifier="g_simple_async_report_error_in_idle" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33697">Reports an error in an asynchronous function in an idle function by
|
|
directly setting the contents of the #GAsyncResult with the given error
|
|
information.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_task_report_error().</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="140"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33699">a #GObject, or %NULL.</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33700">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33701">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="domain" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33702">a #GQuark containing the error domain (usually #G_IO_ERROR).</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</parameter>
|
|
<parameter name="code" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33703">a specific error code.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</parameter>
|
|
<parameter name="format" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33704">a formatted error reporting string.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="..." transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33705">a list of variables to fill in @format.</doc>
|
|
<varargs/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="simple_async_report_gerror_in_idle" c:identifier="g_simple_async_report_gerror_in_idle" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33715">Reports an error in an idle function. Similar to
|
|
g_simple_async_report_error_in_idle(), but takes a #GError rather
|
|
than building a new one.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_task_report_error().</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="148"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33717">a #GObject, or %NULL</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33718">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33719">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33720">the #GError to report</doc>
|
|
<type name="GLib.Error" c:type="const GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="simple_async_report_take_gerror_in_idle" c:identifier="g_simple_async_report_take_gerror_in_idle" version="2.28" introspectable="0" deprecated="1" deprecated-version="2.46">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33730">Reports an error in an idle function. Similar to
|
|
g_simple_async_report_gerror_in_idle(), but takes over the caller's
|
|
ownership of @error, so the caller does not have to free it any more.</doc>
|
|
<doc-deprecated xml:space="preserve">Use g_task_report_error().</doc-deprecated>
|
|
<source-position filename="gsimpleasyncresult.h" line="153"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="object" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33732">a #GObject, or %NULL</doc>
|
|
<type name="GObject.Object" c:type="GObject*"/>
|
|
</parameter>
|
|
<parameter name="callback" transfer-ownership="none" nullable="1" allow-none="1" scope="async" closure="2">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33733">a #GAsyncReadyCallback.</doc>
|
|
<type name="AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
|
|
</parameter>
|
|
<parameter name="user_data" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33734">user data passed to @callback.</doc>
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</parameter>
|
|
<parameter name="error" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="33735">the #GError to report</doc>
|
|
<type name="GLib.Error" c:type="GError*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="srv_target_list_sort" c:identifier="g_srv_target_list_sort" moved-to="SrvTarget.list_sort" version="2.22" introspectable="0">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36919">Sorts @targets in place according to the algorithm in RFC 2782.</doc>
|
|
<source-position filename="gsrvtarget.h" line="54"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36925">the head of the sorted list.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="targets" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="36921">a #GList of #GSrvTarget</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="gpointer" c:type="gpointer"/>
|
|
</type>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="tls_backend_get_default" c:identifier="g_tls_backend_get_default" moved-to="TlsBackend.get_default" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38677">Gets the default #GTlsBackend for the system.</doc>
|
|
<source-position filename="gtlsbackend.h" line="84"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="38682">a #GTlsBackend</doc>
|
|
<type name="TlsBackend" c:type="GTlsBackend*"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="tls_client_connection_new" c:identifier="g_tls_client_connection_new" moved-to="TlsClientConnection.new" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39018">Creates a new #GTlsClientConnection wrapping @base_io_stream (which
|
|
must have pollable input and output streams) which is assumed to
|
|
communicate with the server identified by @server_identity.
|
|
|
|
See the documentation for #GTlsConnection:base-io-stream for restrictions
|
|
on when application code can run operations on the @base_io_stream after
|
|
this function has returned.</doc>
|
|
<source-position filename="gtlsclientconnection.h" line="58"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39032">the new
|
|
#GTlsClientConnection, or %NULL on error</doc>
|
|
<type name="TlsClientConnection" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_io_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39020">the #GIOStream to wrap</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="server_identity" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39021">the expected identity of the server</doc>
|
|
<type name="SocketConnectable" c:type="GSocketConnectable*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="tls_error_quark" c:identifier="g_tls_error_quark" moved-to="TlsError.quark" version="2.28">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39758">Gets the TLS error quark.</doc>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39763">a #GQuark.</doc>
|
|
<type name="GLib.Quark" c:type="GQuark"/>
|
|
</return-value>
|
|
</function>
|
|
<function name="tls_file_database_new" c:identifier="g_tls_file_database_new" moved-to="TlsFileDatabase.new" version="2.30" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39768">Creates a new #GTlsFileDatabase which uses anchor certificate authorities
|
|
in @anchors to verify certificate chains.
|
|
|
|
The certificates in @anchors must be PEM encoded.</doc>
|
|
<source-position filename="gtlsfiledatabase.h" line="53"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39778">the new
|
|
#GTlsFileDatabase, or %NULL on error</doc>
|
|
<type name="TlsFileDatabase" c:type="GTlsDatabase*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="anchors" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="39770">filename of anchor certificate authorities.</doc>
|
|
<type name="filename" c:type="const gchar*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="tls_server_connection_new" c:identifier="g_tls_server_connection_new" moved-to="TlsServerConnection.new" version="2.28" throws="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40135">Creates a new #GTlsServerConnection wrapping @base_io_stream (which
|
|
must have pollable input and output streams).
|
|
|
|
See the documentation for #GTlsConnection:base-io-stream for restrictions
|
|
on when application code can run operations on the @base_io_stream after
|
|
this function has returned.</doc>
|
|
<source-position filename="gtlsserverconnection.h" line="63"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40148">the new
|
|
#GTlsServerConnection, or %NULL on error</doc>
|
|
<type name="TlsServerConnection" c:type="GIOStream*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="base_io_stream" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40137">the #GIOStream to wrap</doc>
|
|
<type name="IOStream" c:type="GIOStream*"/>
|
|
</parameter>
|
|
<parameter name="certificate" transfer-ownership="none" nullable="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40138">the default server certificate, or %NULL</doc>
|
|
<type name="TlsCertificate" c:type="GTlsCertificate*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_is_mount_path_system_internal" c:identifier="g_unix_is_mount_path_system_internal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40645">Determines if @mount_path is considered an implementation of the
|
|
OS. This is primarily used for hiding mountable and mounted volumes
|
|
that only are used in the OS and has little to no relevance to the
|
|
casual user.</doc>
|
|
<source-position filename="gunixmounts.h" line="159"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40654">%TRUE if @mount_path is considered an implementation detail
|
|
of the OS.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40647">a mount path, e.g. `/media/disk` or `/usr`</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_is_system_device_path" c:identifier="g_unix_is_system_device_path" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40659">Determines if @device_path is considered a block device path which is only
|
|
used in implementation of the OS. This is primarily used for hiding
|
|
mounted volumes that are intended as APIs for programs to read, and system
|
|
administrators at a shell; rather than something that should, for example,
|
|
appear in a GUI. For example, the Linux `/proc` filesystem.
|
|
|
|
The list of device paths considered ‘system’ ones may change over time.</doc>
|
|
<source-position filename="gunixmounts.h" line="163"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40671">%TRUE if @device_path is considered an implementation detail of
|
|
the OS.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="device_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40661">a device path, e.g. `/dev/loop0` or `nfsd`</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_is_system_fs_type" c:identifier="g_unix_is_system_fs_type" version="2.56">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40677">Determines if @fs_type is considered a type of file system which is only
|
|
used in implementation of the OS. This is primarily used for hiding
|
|
mounted volumes that are intended as APIs for programs to read, and system
|
|
administrators at a shell; rather than something that should, for example,
|
|
appear in a GUI. For example, the Linux `/proc` filesystem.
|
|
|
|
The list of file system types considered ‘system’ ones may change over time.</doc>
|
|
<source-position filename="gunixmounts.h" line="161"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40689">%TRUE if @fs_type is considered an implementation detail of the OS.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="fs_type" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40679">a file system type, e.g. `procfs` or `tmpfs`</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_at" c:identifier="g_unix_mount_at">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40694">Gets a #GUnixMountEntry for a given mount path. If @time_read
|
|
is set, it will be filled with a unix timestamp for checking
|
|
if the mounts have changed since with g_unix_mounts_changed_since().
|
|
|
|
If more mounts have the same mount path, the last matching mount
|
|
is returned.</doc>
|
|
<source-position filename="gunixmounts.h" line="138"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40706">a #GUnixMountEntry.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40696">path for a possible unix mount.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="time_read" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40697">guint64 to contain a timestamp.</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_compare" c:identifier="g_unix_mount_compare">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40710">Compares two unix mounts.</doc>
|
|
<source-position filename="gunixmounts.h" line="76"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40717">1, 0 or -1 if @mount1 is greater than, equal to,
|
|
or less than @mount2, respectively.</doc>
|
|
<type name="gint" c:type="gint"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount1" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40712">first #GUnixMountEntry to compare.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
<parameter name="mount2" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40713">second #GUnixMountEntry to compare.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_copy" c:identifier="g_unix_mount_copy" version="2.54">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40722">Makes a copy of @mount_entry.</doc>
|
|
<source-position filename="gunixmounts.h" line="70"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40728">a new #GUnixMountEntry</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40724">a #GUnixMountEntry.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_for" c:identifier="g_unix_mount_for" version="2.52">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40733">Gets a #GUnixMountEntry for a given file path. If @time_read
|
|
is set, it will be filled with a unix timestamp for checking
|
|
if the mounts have changed since with g_unix_mounts_changed_since().
|
|
|
|
If more mounts have the same mount path, the last matching mount
|
|
is returned.</doc>
|
|
<source-position filename="gunixmounts.h" line="141"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40745">a #GUnixMountEntry.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="file_path" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40735">file path on some unix mount.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</parameter>
|
|
<parameter name="time_read" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40736">guint64 to contain a timestamp.</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_free" c:identifier="g_unix_mount_free">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40750">Frees a unix mount.</doc>
|
|
<source-position filename="gunixmounts.h" line="68"/>
|
|
<return-value transfer-ownership="none">
|
|
<type name="none" c:type="void"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40752">a #GUnixMountEntry.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_get_device_path" c:identifier="g_unix_mount_get_device_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40758">Gets the device path for a unix mount.</doc>
|
|
<source-position filename="gunixmounts.h" line="81"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40764">a string containing the device path.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40760">a #GUnixMount.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_get_fs_type" c:identifier="g_unix_mount_get_fs_type">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40768">Gets the filesystem type for the unix mount.</doc>
|
|
<source-position filename="gunixmounts.h" line="85"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40774">a string containing the file system type.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40770">a #GUnixMount.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_get_mount_path" c:identifier="g_unix_mount_get_mount_path">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40778">Gets the mount path for a unix mount.</doc>
|
|
<source-position filename="gunixmounts.h" line="79"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40784">the mount path for @mount_entry.</doc>
|
|
<type name="filename" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40780">input #GUnixMountEntry to get the mount path for.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_get_options" c:identifier="g_unix_mount_get_options" version="2.58">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40788">Gets a comma-separated list of mount options for the unix mount. For example,
|
|
`rw,relatime,seclabel,data=ordered`.
|
|
|
|
This is similar to g_unix_mount_point_get_options(), but it takes
|
|
a #GUnixMountEntry as an argument.</doc>
|
|
<source-position filename="gunixmounts.h" line="87"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40798">a string containing the options, or %NULL if not
|
|
available.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40790">a #GUnixMountEntry.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_get_root_path" c:identifier="g_unix_mount_get_root_path" version="2.60">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40804">Gets the root of the mount within the filesystem. This is useful e.g. for
|
|
mounts created by bind operation, or btrfs subvolumes.
|
|
|
|
For example, the root path is equal to "/" for mount created by
|
|
"mount /dev/sda1 /mnt/foo" and "/bar" for
|
|
"mount --bind /mnt/foo/bar /mnt/bar".</doc>
|
|
<source-position filename="gunixmounts.h" line="83"/>
|
|
<return-value transfer-ownership="none" nullable="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40815">a string containing the root, or %NULL if not supported.</doc>
|
|
<type name="utf8" c:type="const char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40806">a #GUnixMountEntry.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_guess_can_eject" c:identifier="g_unix_mount_guess_can_eject">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40820">Guesses whether a Unix mount can be ejected.</doc>
|
|
<source-position filename="gunixmounts.h" line="93"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40826">%TRUE if @mount_entry is deemed to be ejectable.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40822">a #GUnixMountEntry</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_guess_icon" c:identifier="g_unix_mount_guess_icon">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40830">Guesses the icon of a Unix mount.</doc>
|
|
<source-position filename="gunixmounts.h" line="99"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40836">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40832">a #GUnixMountEntry</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_guess_name" c:identifier="g_unix_mount_guess_name">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40840">Guesses the name of a Unix mount.
|
|
The result is a translated string.</doc>
|
|
<source-position filename="gunixmounts.h" line="97"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40847">A newly allocated string that must
|
|
be freed with g_free()</doc>
|
|
<type name="utf8" c:type="char*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40842">a #GUnixMountEntry</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_guess_should_display" c:identifier="g_unix_mount_guess_should_display">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40852">Guesses whether a Unix mount should be displayed in the UI.</doc>
|
|
<source-position filename="gunixmounts.h" line="95"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40858">%TRUE if @mount_entry is deemed to be displayable.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40854">a #GUnixMountEntry</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_guess_symbolic_icon" c:identifier="g_unix_mount_guess_symbolic_icon" version="2.34">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40862">Guesses the symbolic icon of a Unix mount.</doc>
|
|
<source-position filename="gunixmounts.h" line="101"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40868">a #GIcon</doc>
|
|
<type name="Icon" c:type="GIcon*"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40864">a #GUnixMountEntry</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_is_readonly" c:identifier="g_unix_mount_is_readonly">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40884">Checks if a unix mount is mounted read only.</doc>
|
|
<source-position filename="gunixmounts.h" line="89"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40890">%TRUE if @mount_entry is read only.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40886">a #GUnixMount.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_is_system_internal" c:identifier="g_unix_mount_is_system_internal">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40894">Checks if a Unix mount is a system mount. This is the Boolean OR of
|
|
g_unix_is_system_fs_type(), g_unix_is_system_device_path() and
|
|
g_unix_is_mount_path_system_internal() on @mount_entry’s properties.
|
|
|
|
The definition of what a ‘system’ mount entry is may change over time as new
|
|
file system types and device paths are ignored.</doc>
|
|
<source-position filename="gunixmounts.h" line="91"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40905">%TRUE if the unix mount is for a system path.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="mount_entry" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="40896">a #GUnixMount.</doc>
|
|
<type name="UnixMountEntry" c:type="GUnixMountEntry*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_points_changed_since" c:identifier="g_unix_mount_points_changed_since">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41116">Checks if the unix mount points have changed since a given unix time.</doc>
|
|
<source-position filename="gunixmounts.h" line="146"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41122">%TRUE if the mount points have changed since @time.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="time" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41118">guint64 to contain a timestamp.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mount_points_get" c:identifier="g_unix_mount_points_get">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41126">Gets a #GList of #GUnixMountPoint containing the unix mount points.
|
|
If @time_read is set, it will be filled with the mount timestamp,
|
|
allowing for checking if the mounts have changed with
|
|
g_unix_mount_points_changed_since().</doc>
|
|
<source-position filename="gunixmounts.h" line="134"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41135">
|
|
a #GList of the UNIX mountpoints.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="UnixMountPoint"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="time_read" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41128">guint64 to contain a timestamp.</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mounts_changed_since" c:identifier="g_unix_mounts_changed_since">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41140">Checks if the unix mounts have changed since a given unix time.</doc>
|
|
<source-position filename="gunixmounts.h" line="144"/>
|
|
<return-value transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41146">%TRUE if the mounts have changed since @time.</doc>
|
|
<type name="gboolean" c:type="gboolean"/>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="time" transfer-ownership="none">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41142">guint64 to contain a timestamp.</doc>
|
|
<type name="guint64" c:type="guint64"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
<function name="unix_mounts_get" c:identifier="g_unix_mounts_get">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41150">Gets a #GList of #GUnixMountEntry containing the unix mounts.
|
|
If @time_read is set, it will be filled with the mount
|
|
timestamp, allowing for checking if the mounts have changed
|
|
with g_unix_mounts_changed_since().</doc>
|
|
<source-position filename="gunixmounts.h" line="136"/>
|
|
<return-value transfer-ownership="full">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41159">
|
|
a #GList of the UNIX mounts.</doc>
|
|
<type name="GLib.List" c:type="GList*">
|
|
<type name="UnixMountEntry"/>
|
|
</type>
|
|
</return-value>
|
|
<parameters>
|
|
<parameter name="time_read" direction="out" caller-allocates="0" transfer-ownership="full" optional="1" allow-none="1">
|
|
<doc xml:space="preserve" filename="gio-2.0.c" line="41152">guint64 to contain a timestamp, or %NULL</doc>
|
|
<type name="guint64" c:type="guint64*"/>
|
|
</parameter>
|
|
</parameters>
|
|
</function>
|
|
</namespace>
|
|
</repository>
|