diff --git a/rust-bindings/rust/Makefile b/rust-bindings/rust/Makefile index 04fbe7fb..fbcf0c02 100644 --- a/rust-bindings/rust/Makefile +++ b/rust-bindings/rust/Makefile @@ -1,6 +1,6 @@ all: gir/ostree gir/ostree-sys -.PHONY: update-gir-files +.PHONY: update-gir-files remove-gir-files merge-lgpl-docs # -- gir generation -- diff --git a/rust-bindings/rust/conf/ostree.toml b/rust-bindings/rust/conf/ostree.toml index c45012ee..75b89e1b 100644 --- a/rust-bindings/rust/conf/ostree.toml +++ b/rust-bindings/rust/conf/ostree.toml @@ -5,6 +5,8 @@ version = "1.0" target_path = ".." doc_target_path = "../target/vendor.md" deprecate_by_min_version = true +single_version_file = true +generate_display_trait = true girs_dir = "../gir-files" diff --git a/rust-bindings/rust/gir-files/GLib-2.0.gir b/rust-bindings/rust/gir-files/GLib-2.0.gir index f57eb45b..4aa9d736 100644 --- a/rust-bindings/rust/gir-files/GLib-2.0.gir +++ b/rust-bindings/rust/gir-files/GLib-2.0.gir @@ -36,6 +36,9 @@ the g_spawn functions. particular string. A GQuark value of zero is associated to %NULL. + + + A typedef alias for gchar**. This is mostly useful when used together with g_auto(). @@ -171,7 +174,15 @@ functions. - Inserts @len elements into a #GArray at the given index. + Inserts @len elements into a #GArray at the given index. + +If @index_ is greater than the array’s current length, the array is expanded. +The elements between the old end of the array and the newly inserted elements +will be initialised to zero if the array was configured to clear elements; +otherwise their values will be undefined. + +@data may be %NULL if (and only if) @len is zero. If @len is zero, this +function is a no-op. the #GArray @@ -189,7 +200,7 @@ functions. the index to place the elements at - + a pointer to the elements to insert @@ -227,6 +238,9 @@ functions. Adds @len elements onto the start of the array. +@data may be %NULL if (and only if) @len is zero. If @len is zero, this +function is a no-op. + This operation is slower than g_array_append_vals() since the existing elements in the array have to be moved to make space for the new elements. @@ -243,12 +257,12 @@ the new elements. - + a pointer to the elements to prepend to the start of the array - the number of elements to prepend + the number of elements to prepend, which may be zero @@ -1205,8 +1219,8 @@ In the event the URI cannot be found, -1 is returned and - Gets the registration informations of @app_name for the bookmark for -@uri. See g_bookmark_file_set_app_info() for more informations about + Gets the registration information of @app_name for the bookmark for +@uri. See g_bookmark_file_set_app_info() for more information about the returned data. The string returned in @app_exec must be freed. @@ -1583,7 +1597,7 @@ structure. If the object cannot be created then @error is set to a desktop bookmarks loaded in memory - + @@ -1597,7 +1611,7 @@ structure. If the object cannot be created then @error is set to a This function looks for a desktop bookmark file named @file in the paths returned from g_get_user_data_dir() and g_get_system_data_dirs(), loads the file into @bookmark and returns the file's full path in -@full_path. If the file could not be loaded then an %error is +@full_path. If the file could not be loaded then @error is set to either a #GFileError or #GBookmarkFileError. %TRUE if a key file could be loaded, %FALSE otherwise @@ -1864,7 +1878,7 @@ If @uri cannot be found then an item for it is created. an array of group names, or %NULL to remove all groups - + @@ -2587,10 +2601,17 @@ been called to indicate that the bytes is no longer in use. Compares the two #GBytes values. -This function can be used to sort GBytes instances in lexographical order. +This function can be used to sort GBytes instances in lexicographical order. + +If @bytes1 and @bytes2 have different length but the shorter one is a +prefix of the longer one then the shorter one is considered to be less than +the longer one. Otherwise the first byte where both differ is used for +comparison. If @bytes1 has a smaller value at that position it is +considered less, otherwise greater than @bytes2. - a negative value if bytes2 is lesser, a positive value if bytes2 is - greater, and zero if bytes2 is equal to bytes1 + a negative value if @bytes1 is less than @bytes2, a positive value + if @bytes1 is greater than @bytes2, and zero if @bytes1 is equal to + @bytes2 @@ -2879,9 +2900,11 @@ no longer be updated with g_checksum_update(). output buffer - + + + - + an inout parameter. The caller initializes it to the size of @buffer. After the call it contains the length of the digest. @@ -2934,7 +2957,7 @@ not have been called on @checksum. buffer used to compute the checksum - + @@ -3962,7 +3985,10 @@ the user's current timezone. To set the value of a date to the current day, you could write: |[<!-- language="C" --> - g_date_set_time_t (date, time (NULL)); + time_t now = time (NULL); + if (now == (time_t) -1) + // handle the error + g_date_set_time_t (date, now); ]| @@ -5146,6 +5172,19 @@ including the fractional part. + + Get the time zone for this @datetime. + + the time zone + + + + + a #GDateTime + + + + Determines the time zone abbreviation to be used at the time and in the time zone of @datetime. @@ -6984,6 +7023,45 @@ without calling the key and value destroy functions. + + Looks up a key in the #GHashTable, stealing the original key and the +associated value and returning %TRUE if the key was found. If the key was +not found, %FALSE is returned. + +If found, the stolen key and value are removed from the hash table without +calling the key and value destroy functions, and ownership is transferred to +the caller of this method; as with g_hash_table_steal(). + +You can pass %NULL for @lookup_key, provided the hash and equal functions +of @hash_table are %NULL-safe. + + %TRUE if the key was found in the #GHashTable + + + + + a #GHashTable + + + + + + + the key to look up + + + + return location for the + original key + + + + return location + for the value associated with the key + + + + Atomically decrements the reference count of @hash_table by one. If the reference count drops to 0, all keys and values will be @@ -7199,9 +7277,11 @@ no longer be updated with g_checksum_update(). output buffer - + + + - + an inout parameter. The caller initializes it to the size of @buffer. After the call it contains the length of the digest @@ -7275,7 +7355,7 @@ g_hmac_get_digest() must not have been called on @hmac. buffer used to compute the checksum - + @@ -7314,7 +7394,7 @@ Support for %G_CHECKSUM_SHA384 was added in GLib 2.52. the key for the HMAC - + @@ -8838,7 +8918,7 @@ cases described in the documentation for g_io_channel_set_encoding (). a buffer to write data from - + @@ -10050,7 +10130,7 @@ file, a %G_FILE_ERROR is returned. If there is a problem parsing the file, a %NULL-terminated array of directories to search - + @@ -10490,7 +10570,7 @@ it is created. a %NULL-terminated array of locale string values - + @@ -10885,8 +10965,10 @@ a copy of each list element, in addition to copying the list container itself. @func, as a #GCopyFunc, takes two arguments, the data to be copied -and a @user_data pointer. It's safe to pass %NULL as user_data, -if the copy function takes only one argument. +and a @user_data pointer. On common processor architectures, it's safe to +pass %NULL as @user_data if the copy function takes only one argument. You +may get compiler warnings from this though if compiling with GCC’s +`-Wcast-function-type` warning. For instance, if @list holds a list of GObjects, you can do: |[<!-- language="C" --> @@ -11691,7 +11773,7 @@ chained and fall back to simpler handlers in case of failure. fields forming the message - + @@ -11783,7 +11865,7 @@ linked against at application run time. The minimum value which can be held in a #gint8. - + The minor version number of the GLib library. Like #gtk_minor_version, but from the headers used at @@ -12316,12 +12398,13 @@ the result is zero, free the context and free all associated memory. - + Tries to become the owner of the specified context, as with g_main_context_acquire(). But if another thread is the owner, atomically drop @mutex and wait on @cond until that owner releases ownership or until @cond is signaled, then try again (once) to become the owner. + Use g_main_context_is_owner() and separate locking instead. %TRUE if the operation succeeded, and this thread is now the owner of @context. @@ -15348,7 +15431,7 @@ which have been added to a #GOptionContext. Increments the reference count of @group by one. - a #GoptionGroup + a #GOptionGroup @@ -16048,7 +16131,8 @@ pointer was not found. Removes the pointer at the given index from the pointer array. The following elements are moved down one place. If @array has a non-%NULL #GDestroyNotify function it is called for the removed -element. +element. If so, the return value from this function will potentially point +to freed memory (depending on the #GDestroyNotify implementation). the pointer which was removed @@ -16071,7 +16155,9 @@ element. The last element in the array is used to fill in the space, so this function does not preserve the order of the array. But it is faster than g_ptr_array_remove_index(). If @array has a non-%NULL -#GDestroyNotify function it is called for the removed element. +#GDestroyNotify function it is called for the removed element. If so, the +return value from this function will potentially point to freed memory +(depending on the #GDestroyNotify implementation). the pointer which was removed @@ -16233,6 +16319,52 @@ This is guaranteed to be a stable sort since version 2.32. + + Removes the pointer at the given index from the pointer array. +The following elements are moved down one place. The #GDestroyNotify for +@array is *not* called on the removed element; ownership is transferred to +the caller of this function. + + the pointer which was removed + + + + + a #GPtrArray + + + + + + the index of the pointer to steal + + + + + + Removes the pointer at the given index from the pointer array. +The last element in the array is used to fill in the space, so +this function does not preserve the order of the array. But it +is faster than g_ptr_array_steal_index(). The #GDestroyNotify for @array is +*not* called on the removed element; ownership is transferred to the caller +of this function. + + the pointer which was removed + + + + + a #GPtrArray + + + + + + the index of the pointer to steal + + + + Atomically decrements the reference count of @array by one. If the reference count drops to 0, the effect is the same as calling @@ -17727,11 +17859,13 @@ the string passed to g_regex_new(). - Scans for a match in string for the pattern in @regex. + Scans for a match in @string for the pattern in @regex. The @match_options are combined with the match options specified when the @regex structure was created, letting you have more flexibility in reusing #GRegex structures. +Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. + A #GMatchInfo structure, used to get information on the match, is stored in @match_info if not %NULL. Note that if @match_info is not %NULL then it is created even if the function returns %FALSE, @@ -17830,7 +17964,7 @@ freeing or modifying @string then the behaviour is undefined. Using the standard algorithm for regular expression matching only -the longest match in the string is retrieved, it is not possible +the longest match in the @string is retrieved, it is not possible to obtain all the available matches. For instance matching "<a> <b> <c>" against the pattern "<.*>" you get "<a> <b> <c>". @@ -17856,6 +17990,8 @@ Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". +Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. + A #GMatchInfo structure, used to get information on the match, is stored in @match_info if not %NULL. Note that if @match_info is not %NULL then it is created even if the function returns %FALSE, @@ -17876,12 +18012,12 @@ freeing or modifying @string then the behaviour is undefined. the string to scan for matches - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -17900,7 +18036,7 @@ freeing or modifying @string then the behaviour is undefined. - Scans for a match in string for the pattern in @regex. + Scans for a match in @string for the pattern in @regex. The @match_options are combined with the match options specified when the @regex structure was created, letting you have more flexibility in reusing #GRegex structures. @@ -17909,6 +18045,8 @@ Setting @start_position differs from just passing over a shortened string and setting #G_REGEX_MATCH_NOTBOL in the case of a pattern that begins with any kind of lookbehind assertion, such as "\b". +Unless %G_REGEX_RAW is specified in the options, @string must be valid UTF-8. + A #GMatchInfo structure, used to get information on the match, is stored in @match_info if not %NULL. Note that if @match_info is not %NULL then it is created even if the function returns %FALSE, @@ -17960,12 +18098,12 @@ print_uppercase_words (const gchar *string) the string to scan for matches - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -18034,12 +18172,12 @@ begins with any kind of lookbehind assertion, such as "\b". the string to perform matches against - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -18113,12 +18251,12 @@ g_hash_table_destroy (h); string to perform matches against - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -18159,12 +18297,12 @@ assertion, such as "\b". the string to perform matches against - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -18257,12 +18395,12 @@ it using g_strfreev() the string to split with the pattern - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -18360,12 +18498,12 @@ in @length. the string to escape - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -19045,9 +19183,11 @@ to copy the data as well. In contrast with g_slist_copy(), this function uses @func to make a copy of each list element, in addition to copying the list container itself. -@func, as a #GCopyFunc, takes two arguments, the data to be copied and a user -pointer. It's safe to pass #NULL as user_data, if the copy function takes only -one argument. +@func, as a #GCopyFunc, takes two arguments, the data to be copied +and a @user_data pointer. On common processor architectures, it's safe to +pass %NULL as @user_data if the copy function takes only one argument. You +may get compiler warnings from this though if compiling with GCC’s +`-Wcast-function-type` warning. For instance, if @list holds a list of GObjects, you can do: |[<!-- language="C" --> @@ -19059,7 +19199,7 @@ And, to entirely free the new list, you could do: g_slist_free_full (another_list, g_object_unref); ]| - a full copy of @list, use #g_slist_free_full to free it + a full copy of @list, use g_slist_free_full() to free it @@ -20505,14 +20645,14 @@ when comparing the length to zero. - Inserts @data into @sequence using @func to determine the new + Inserts @data into @seq using @cmp_func to determine the new position. The sequence must already be sorted according to @cmp_func; otherwise the new position of @data is undefined. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value -if the second item comes before the first. +if the second item comes before the first. Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call @@ -20550,11 +20690,6 @@ It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. -It is called with two iterators pointing into @seq. It should -return 0 if the iterators are equal, a negative value if the -first iterator comes before the second, and a positive value -if the second iterator comes before the first. - Note that when adding a large amount of data to a #GSequence, it is more efficient to do unsorted insertions and then call g_sequence_sort() or g_sequence_sort_iter(). @@ -20576,7 +20711,7 @@ g_sequence_sort() or g_sequence_sort_iter(). - user data passed to @cmp_func + user data passed to @iter_cmp @@ -20605,7 +20740,7 @@ item is equal, it is not guaranteed that it is the first which is returned. In that case, you can use g_sequence_iter_next() and g_sequence_iter_prev() to get others. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. @@ -20650,7 +20785,7 @@ This function will fail if the data contained in the sequence is unsorted. an #GSequenceIter pointing to the position of - the first item found equal to @data according to @cmp_func + the first item found equal to @data according to @iter_cmp and @cmp_data, or %NULL if no such item exists @@ -20694,7 +20829,7 @@ unsorted. Returns an iterator pointing to the position where @data would be inserted according to @cmp_func and @cmp_data. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. @@ -20794,7 +20929,7 @@ if the second comes before the first. Like g_sequence_sort(), but uses a #GSequenceIterCompareFunc instead -of a GCompareDataFunc as the compare function +of a #GCompareDataFunc as the compare function @cmp_func is called with two iterators pointing into @seq. It should return 0 if the iterators are equal, a negative value if the first @@ -20895,13 +21030,13 @@ sequences. - Inserts the (@begin, @end) range at the destination pointed to by ptr. + Inserts the (@begin, @end) range at the destination pointed to by @dest. The @begin and @end iters must point into the same sequence. It is allowed for @dest to point to a different sequence than the one pointed into by @begin and @end. -If @dest is NULL, the range indicated by @begin and @end is -removed from the sequence. If @dest iter points to a place within +If @dest is %NULL, the range indicated by @begin and @end is +removed from the sequence. If @dest points to a place within the (@begin, @end) range, the range does not move. @@ -21013,12 +21148,13 @@ function is called on the existing data that @iter pointed to. - Moves the data pointed to a new position as indicated by @cmp_func. This + Moves the data pointed to by @iter to a new position as indicated by +@cmp_func. This function should be called for items in a sequence already sorted according to @cmp_func whenever some aspect of an item changes so that @cmp_func may return different values for that item. -@cmp_func is called with two items of the @seq and @user_data. +@cmp_func is called with two items of the @seq, and @cmp_data. It should return 0 if the items are equal, a negative value if the first item comes before the second, and a positive value if the second item comes before the first. @@ -21045,7 +21181,8 @@ the second item comes before the first. a #GSequenceIterCompareFunc instead of a #GCompareDataFunc as the compare function. -@iter_cmp is called with two iterators pointing into @seq. It should +@iter_cmp is called with two iterators pointing into the #GSequence that +@iter points into. It should return 0 if the iterators are equal, a negative value if the first iterator comes before the second, and a positive value if the second iterator comes before the first. @@ -21516,7 +21653,12 @@ g_get_current_time(). Returns the numeric ID for a particular source. The ID of a source is a positive integer which is unique within a particular main loop context. The reverse -mapping from ID to source is done by g_main_context_find_source_by_id(). +mapping from ID to source is done by g_main_context_find_source_by_id(). + +You can only call this function while the source is associated to a +#GMainContext instance; calling this function before g_source_attach() +or after g_source_destroy() yields undefined behavior. The ID returned +is unique within the #GMainContext instance passed to g_source_attach(). the ID (greater than 0) for the source @@ -21809,7 +21951,8 @@ called from the source's dispatch function. The exact type of @func depends on the type of source; ie. you should not count on @func being called with @data as its first -parameter. +parameter. Cast @func with G_SOURCE_FUNC() to avoid warnings about +incompatible function types. See [memory management of sources][mainloop-memory-management] for details on how to handle memory management of @data. @@ -22161,7 +22304,11 @@ which cannot be used here for dependency reasons. Specifies the type of function passed to g_timeout_add(), -g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). +g_timeout_add_full(), g_idle_add(), and g_idle_add_full(). + +When calling g_source_set_callback(), you may need to cast a function of a +different type to this type. Use G_SOURCE_FUNC() to avoid warnings about +incompatible function types. %FALSE if the source should be removed. #G_SOURCE_CONTINUE and #G_SOURCE_REMOVE are more memorable names for the return value. @@ -24127,7 +24274,9 @@ UNIX system call. GLib is attempting to unify around the use of 64bit integers to represent microsecond-precision time. As such, this type will be -removed from a future version of GLib. +removed from a future version of GLib. A consequence of using `glong` for +`tv_sec` is that on 32-bit systems `GTimeVal` is subject to the year 2038 +problem. seconds @@ -24176,10 +24325,12 @@ Use g_date_time_format() or g_strdup_printf() if a different variation of ISO 8601 format is required. If @time_ represents a date which is too large to fit into a `struct tm`, -%NULL will be returned. This is platform dependent, but it is safe to assume -years up to 3000 are supported. The return value of g_time_val_to_iso8601() -has been nullable since GLib 2.54; before then, GLib would crash under the -same conditions. +%NULL will be returned. This is platform dependent. Note also that since +`GTimeVal` stores the number of seconds as a `glong`, on 32-bit systems it +is subject to the year 2038 problem. + +The return value of g_time_val_to_iso8601() has been nullable since GLib +2.54; before then, GLib would crash under the same conditions. a newly allocated string containing an ISO 8601 date, or %NULL if @time_ was too large @@ -24199,7 +24350,9 @@ to a #GTimeVal and puts it into @time_. @iso_date must include year, month, day, hours, minutes, and seconds. It can optionally include fractions of a second and a time zone indicator. (In the absence of any time zone indication, the -timestamp is assumed to be in local time.) +timestamp is assumed to be in local time.) + +Any leading or trailing space in @iso_date is ignored. %TRUE if the conversion was successful. @@ -24309,6 +24462,23 @@ when you are done with it. + + Creates a #GTimeZone corresponding to the given constant offset from UTC, +in seconds. + +This is equivalent to calling g_time_zone_new() with a string in the form +`[+|-]hh[:mm[:ss]]`. + + a timezone at the given offset from UTC + + + + + offset to UTC, in seconds + + + + Creates a #GTimeZone corresponding to UTC. @@ -24418,6 +24588,26 @@ is in effect. + + Get the identifier of this #GTimeZone, as passed to g_time_zone_new(). +If the identifier passed at construction time was not recognised, `UTC` will +be returned. If it was %NULL, the identifier of the local timezone at +construction time will be returned. + +The identifier will be returned in the same format as provided at +construction time: if provided as a time offset, that will be returned by +this function. + + identifier for this timezone + + + + + a #GTimeZone + + + + Determines the offset to UTC in effect during a particular @interval of time in the time zone @tz. @@ -25873,6 +26063,27 @@ See [Unicode Standard Annex #24: Script names](http://www.unicode.org/reports/tr Zanabazar Square. Since: 2.54 + + Dogra. Since: 2.58 + + + Gunjala Gondi. Since: 2.58 + + + Hanifi Rohingya. Since: 2.58 + + + Makasar. Since: 2.58 + + + Medefaidrin. Since: 2.58 + + + Old Sogdian. Since: 2.58 + + + Sogdian. Since: 2.58 + These are the possible character classifications from the @@ -26360,7 +26571,7 @@ new instance takes ownership of them as if via g_variant_ref_sink(). an array of #GVariant pointers, the children - + @@ -26392,7 +26603,7 @@ new instance takes ownership of them as if via g_variant_ref_sink(). a #guint8 value - + @@ -26411,7 +26622,7 @@ the array. a normal nul-terminated string in no particular encoding - + @@ -26429,7 +26640,7 @@ If @length is -1 then @strv is %NULL-terminated. an array of strings - + @@ -26705,7 +26916,7 @@ If @length is -1 then @strv is %NULL-terminated. an array of strings - + @@ -26866,7 +27077,7 @@ If @length is -1 then @strv is %NULL-terminated. an array of strings - + @@ -26916,7 +27127,7 @@ new instance takes ownership of them as if via g_variant_ref_sink(). the items to make the tuple out of - + @@ -27353,8 +27564,8 @@ other than %G_VARIANT_TYPE_BOOLEAN. It is an error to call this function with a @value of any type other than %G_VARIANT_TYPE_BYTE. - a #guchar - + a #guint8 + @@ -27385,7 +27596,7 @@ The return value remains valid as long as @value exists. the constant string - + @@ -27409,7 +27620,7 @@ For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. an array of constant strings - + @@ -27468,6 +27679,11 @@ in the container. See g_variant_n_children(). The returned value is never floating. You should free it with g_variant_unref() when you're done with it. +There may be implementation specific restrictions on deeply nested values, +which would result in the unit tuple being returned as the child value, +instead of further nested children. #GVariant is guaranteed to handle +nesting up to at least 64 levels. + This function is O(1). the child at the specified index @@ -27569,7 +27785,7 @@ as an array of the given C type, with @element_size set to the size the appropriate type: - %G_VARIANT_TYPE_INT16 (etc.): #gint16 (etc.) - %G_VARIANT_TYPE_BOOLEAN: #guchar (not #gboolean!) -- %G_VARIANT_TYPE_BYTE: #guchar +- %G_VARIANT_TYPE_BYTE: #guint8 - %G_VARIANT_TYPE_HANDLE: #guint32 - %G_VARIANT_TYPE_DOUBLE: #gdouble @@ -27732,7 +27948,7 @@ For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. an array of constant strings - + @@ -27814,7 +28030,7 @@ For an empty array, @length will be set to 0 and a pointer to a %NULL pointer will be returned. an array of constant strings - + @@ -28035,7 +28251,10 @@ check. If @value is found to be in normal form then it will be marked as being trusted. If the value was already marked as being trusted then -this function will immediately return %TRUE. +this function will immediately return %TRUE. + +There may be implementation specific restrictions on deeply nested values. +GVariant is guaranteed to handle nesting up to at least 64 levels. %TRUE if @value is in normal form @@ -28370,10 +28589,10 @@ drops to 0, the memory used by the variant is freed. should ensure that a string is a valid D-Bus object path before passing it to g_variant_new_object_path(). -A valid object path starts with '/' followed by zero or more -sequences of characters separated by '/' characters. Each sequence -must contain only the characters "[A-Z][a-z][0-9]_". No sequence -(including the one following the final '/' character) may be empty. +A valid object path starts with `/` followed by zero or more +sequences of characters separated by `/` characters. Each sequence +must contain only the characters `[A-Z][a-z][0-9]_`. No sequence +(including the one following the final `/` character) may be empty. %TRUE if @string is a D-Bus object path @@ -29740,7 +29959,10 @@ The valid basic type strings are "b", "y", "n", "q", "i", "u", "x", "t", The above definition is recursive to arbitrary depth. "aaaaai" and "(ui(nq((y)))s)" are both valid type strings, as is -"a(aa(ui)(qna{ya(yd)}))". +"a(aa(ui)(qna{ya(yd)}))". In order to not hit memory limits, #GVariant +imposes a limit on recursion depth of 65 nested containers. This is the +limit in the D-Bus specification (64) plus one to allow a #GDBusMessage to +be nested in a top-level tuple. The meaning of each of the characters is as follows: - `b`: the type string of %G_VARIANT_TYPE_BOOLEAN; a boolean value. @@ -29896,7 +30118,7 @@ Since 2.24 an array of #GVariantTypes, one for each item - + @@ -31488,6 +31710,179 @@ This call acts as a full compiler and hardware memory barrier. + + Atomically acquires a reference on the data pointed by @mem_block. + + a pointer to the data, + with its reference count increased + + + + + a pointer to reference counted data + + + + + + Allocates @block_size bytes of memory, and adds atomic +reference counting semantics to it. + +The data will be freed when its reference count drops to +zero. + + a pointer to the allocated memory + + + + + the size of the allocation, must be greater than 0 + + + + + + Allocates @block_size bytes of memory, and adds atomic +referenc counting semantics to it. + +The contents of the returned data is set to zero. + +The data will be freed when its reference count drops to +zero. + + a pointer to the allocated memory + + + + + the size of the allocation, must be greater than 0 + + + + + + Allocates a new block of data with atomit reference counting +semantics, and copies @block_size bytes of @mem_block +into it. + + a pointer to the allocated + memory + + + + + the number of bytes to copy, must be greater than 0 + + + + the memory to copy + + + + + + Retrieves the size of the reference counted data pointed by @mem_block. + + the size of the data, in bytes + + + + + a pointer to reference counted data + + + + + + Atomically releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will free the +resources allocated for @mem_block. + + + + + + a pointer to reference counted data + + + + + + Atomically releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will call @clear_func +to clear the contents of @mem_block, and then will free the +resources allocated for @mem_block. + + + + + + a pointer to reference counted data + + + + a function to call when clearing the data + + + + + + Atomically compares the current value of @arc with @val. + + %TRUE if the reference count is the same + as the given value + + + + + the address of an atomic reference count variable + + + + the value to compare + + + + + + Atomically decreases the reference count. + + %TRUE if the reference count reached 0, and %FALSE otherwise + + + + + the address of an atomic reference count variable + + + + + + Atomically increases the reference count. + + + + + + the address of an atomic reference count variable + + + + + + Atomically initializes a reference count variable. + + + + + + the address of an atomic reference count variable + + + + Decode a sequence of Base-64 encoded text into binary data. Note that the returned binary data is not necessarily zero-terminated, @@ -31550,7 +31945,7 @@ state). binary input data - + @@ -31586,7 +31981,7 @@ representation. the binary data to encode - + @@ -31656,7 +32051,7 @@ or certain other protocols. the binary data to encode - + @@ -32078,6 +32473,38 @@ thread. + + Gets the canonical file name from @filename. All triple slashes are turned into +single slashes, and all `..` and `.`s resolved against @relative_to. + +Symlinks are not followed, and the returned path is guaranteed to be absolute. + +If @filename is an absolute path, @relative_to is ignored. Otherwise, +@relative_to will be prepended to @filename to make it absolute. @relative_to +must be an absolute path, or %NULL. If @relative_to is %NULL, it'll fallback +to g_get_current_dir(). + +This function never fails, and will canonicalize file paths even if they don't +exist. + +No file system I/O is done. + + a newly allocated string with the +canonical file path + + + + + the name of the file + + + + the relative directory, or %NULL +to use the current working directory + + + + A wrapper for the POSIX chdir() function. The function changes the current directory of the process to @path. @@ -32329,7 +32756,11 @@ Otherwise, the variable is destroyed using @destroy and the pointer is set to %NULL. A macro is also included that allows this function to be used without -pointer casts. +pointer casts. This will mask any warnings about incompatible function types +or calling conventions, so you must ensure that your @destroy function is +compatible with being called as `GDestroyNotify` using the standard calling +convention for the platform that GLib was compiled for; otherwise the program +will experience undefined behaviour. @@ -32404,7 +32835,7 @@ The hexadecimal string returned will be in lower case. binary blob to compute the digest of - + @@ -32482,7 +32913,7 @@ The hexadecimal string returned will be in lower case. the key to use in the HMAC - + @@ -32492,7 +32923,7 @@ The hexadecimal string returned will be in lower case. binary blob to compute the HMAC of - + @@ -32519,7 +32950,7 @@ The hexadecimal string returned will be in lower case. the key to use in the HMAC - + @@ -32565,7 +32996,7 @@ well) on many platforms. Consider using g_str_to_ascii() instead. the string to convert. - + @@ -32638,7 +33069,7 @@ could combine with the base character.) the string to convert. - + @@ -32713,7 +33144,7 @@ unrepresentable characters, use g_convert_with_fallback(). the string to convert. - + @@ -33883,6 +34314,17 @@ file which is then renamed to the final name. Notes: lists, metadata etc. may be lost. If @filename is a symbolic link, the link itself will be replaced, not the linked file. +- On UNIX, if @filename already exists and is non-empty, and if the system + supports it (via a journalling filesystem or equivalent), the fsync() + call (or equivalent) will be used to ensure atomic replacement: @filename + will contain either its old contents or @contents, even in the face of + system power loss, the disk being unsafely removed, etc. + +- On UNIX, if @filename does not already exist or is empty, there is a + possibility that system power loss etc. after calling this function will + leave @filename empty or full of NUL bytes, depending on the underlying + filesystem. + - On Windows renaming a file will not remove an existing file with the new name, so on Windows there is a race condition between the existing file being removed and the temporary file being renamed. @@ -33909,7 +34351,7 @@ to 7 characters to @filename. string to write to the file - + @@ -34441,8 +34883,12 @@ on a system might be in any random encoding or just gibberish. - - + + + return location for the %NULL-terminated list of encoding names + + + @@ -34507,11 +34953,36 @@ user. a %NULL-terminated array of strings owned by GLib that must not be modified or freed. - + + + Computes a list of applicable locale names with a locale category name, +which can be used to construct the fallback locale-dependent filenames +or search paths. The returned list is sorted from most desirable to +least desirable and always contains the default locale "C". + +This function consults the environment variables `LANGUAGE`, `LC_ALL`, +@category_name, and `LANG` to find the list of locales specified by the +user. + +g_get_language_names() returns g_get_language_names_with_category("LC_MESSAGES"). + + a %NULL-terminated array of strings owned by GLib + that must not be modified or freed. + + + + + + + a locale category name + + + + Returns a list of derived variants of @locale, which can be used to e.g. construct locale-dependent filenames or search paths. The returned @@ -34627,7 +35098,7 @@ to anyone using the computer. a %NULL-terminated array of strings owned by GLib that must not be modified or freed. - + @@ -34668,7 +35139,7 @@ this function is called. a %NULL-terminated array of strings owned by GLib that must not be modified or freed. - + @@ -35124,6 +35595,45 @@ without calling the key and value destroy functions. + + Looks up a key in the #GHashTable, stealing the original key and the +associated value and returning %TRUE if the key was found. If the key was +not found, %FALSE is returned. + +If found, the stolen key and value are removed from the hash table without +calling the key and value destroy functions, and ownership is transferred to +the caller of this method; as with g_hash_table_steal(). + +You can pass %NULL for @lookup_key, provided the hash and equal functions +of @hash_table are %NULL-safe. + + %TRUE if the key was found in the #GHashTable + + + + + a #GHashTable + + + + + + + the key to look up + + + + return location for the + original key + + + + return location + for the value associated with the key + + + + Atomically decrements the reference count of @hash_table by one. If the reference count drops to 0, all keys and values will be @@ -35807,7 +36317,7 @@ may contain embedded nul characters. a string in the encoding of the current locale. On Windows this means the system codepage. - + @@ -35839,8 +36349,9 @@ may contain embedded nul characters. Logs an error or debugging message. -If the log level has been set as fatal, the abort() -function is called to terminate the program. +If the log level has been set as fatal, G_BREAKPOINT() is called +to terminate the program. See the documentation for G_BREAKPOINT() for +details of the debugging options this provides. If g_log_default_handler() is used as the log handler function, a new-line character will automatically be appended to @..., and need not be entered @@ -35877,7 +36388,7 @@ for the default allows to install an alternate default log handler. This is used if no log handler has been set for the particular log domain and log level combination. It outputs the message to stderr -or stdout and if the log level is fatal it calls abort(). It automatically +or stdout and if the log level is fatal it calls G_BREAKPOINT(). It automatically prints a new-line character after the message, so one does not need to be manually included in @message. @@ -36001,7 +36512,12 @@ This has no effect on structured log messages (using g_log_structured() or g_log_structured_array()). To change the fatal behaviour for specific log messages, programs must install a custom log writer function using g_log_set_writer_func(). See -[Using Structured Logging][using-structured-logging]. +[Using Structured Logging][using-structured-logging]. + +This function is mostly intended to be used with +%G_LOG_LEVEL_CRITICAL. You should typically not set +%G_LOG_LEVEL_WARNING, %G_LOG_LEVEL_MESSAGE, %G_LOG_LEVEL_INFO or +%G_LOG_LEVEL_DEBUG as fatal except inside of test programs. the old fatal mask for the log domain @@ -36144,7 +36660,7 @@ There can only be one writer function. It is an error to set more than one.Log a message with structured data. The message will be passed through to the log writer set by the application using g_log_set_writer_func(). If the message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will -be aborted at the end of this function. If the log writer returns +be aborted by calling G_BREAKPOINT() at the end of this function. If the log writer returns %G_LOG_WRITER_UNHANDLED (failure), no other fallback writers will be tried. See the documentation for #GLogWriterFunc for information on chaining writers. @@ -36262,7 +36778,7 @@ This assumes that @log_level is already present in @fields (typically as the key–value pairs of structured data to add to the log message - + @@ -36364,7 +36880,7 @@ messages unless their log domain (or `all`) is listed in the space-separated key–value pairs of structured data forming the log message - + @@ -36402,7 +36918,7 @@ UTF-8. key–value pairs of structured data forming the log message - + @@ -36461,7 +36977,7 @@ defined, but will always return %G_LOG_WRITER_UNHANDLED. key–value pairs of structured data forming the log message - + @@ -36501,7 +37017,7 @@ This is suitable for use as a #GLogWriterFunc. key–value pairs of structured data forming the log message - + @@ -36533,8 +37049,9 @@ messages. Logs an error or debugging message. -If the log level has been set as fatal, the abort() -function is called to terminate the program. +If the log level has been set as fatal, G_BREAKPOINT() is called +to terminate the program. See the documentation for G_BREAKPOINT() for +details of the debugging options this provides. If g_log_default_handler() is used as the log handler function, a new-line character will automatically be appended to @..., and need not be entered @@ -37324,7 +37841,7 @@ commas, or %NULL. pointer to an array of #GDebugKey which associate strings with bit flags. - + @@ -38000,6 +38517,124 @@ by the g_random_* functions, to @seed. + + Acquires a reference on the data pointed by @mem_block. + + a pointer to the data, + with its reference count increased + + + + + a pointer to reference counted data + + + + + + Allocates @block_size bytes of memory, and adds reference +counting semantics to it. + +The data will be freed when its reference count drops to +zero. + + a pointer to the allocated memory + + + + + the size of the allocation, must be greater than 0 + + + + + + Allocates @block_size bytes of memory, and adds reference +counting semantics to it. + +The contents of the returned data is set to zero. + +The data will be freed when its reference count drops to +zero. + + a pointer to the allocated memory + + + + + the size of the allocation, must be greater than 0 + + + + + + Allocates a new block of data with reference counting +semantics, and copies @block_size bytes of @mem_block +into it. + + a pointer to the allocated + memory + + + + + the number of bytes to copy, must be greater than 0 + + + + the memory to copy + + + + + + Retrieves the size of the reference counted data pointed by @mem_block. + + the size of the data, in bytes + + + + + a pointer to reference counted data + + + + + + Releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will free the +resources allocated for @mem_block. + + + + + + a pointer to reference counted data + + + + + + Releases a reference on the data pointed by @mem_block. + +If the reference was the last one, it will call @clear_func +to clear the contents of @mem_block, and then will free the +resources allocated for @mem_block. + + + + + + a pointer to reference counted data + + + + a function to call when clearing the data + + + + Reallocates the memory pointed to by @mem, so that it now has space for @n_bytes bytes of memory. It returns the new address of the memory, which may @@ -38043,6 +38678,154 @@ but care is taken to detect possible overflow during multiplication. + + Compares the current value of @rc with @val. + + %TRUE if the reference count is the same + as the given value + + + + + the address of a reference count variable + + + + the value to compare + + + + + + Decreases the reference count. + + %TRUE if the reference count reached 0, and %FALSE otherwise + + + + + the address of a reference count variable + + + + + + Increases the reference count. + + + + + + the address of a reference count variable + + + + + + Initializes a reference count variable. + + + + + + the address of a reference count variable + + + + + + Acquires a reference on a string. + + the given string, with its reference count increased + + + + + a reference counted string + + + + + + Retrieves the length of @str. + + the length of the given string, in bytes + + + + + a reference counted string + + + + + + Creates a new reference counted string and copies the contents of @str +into it. + + the newly created reference counted string + + + + + a NUL-terminated string + + + + + + Creates a new reference counted string and copies the content of @str +into it. + +If you call this function multiple times with the same @str, or with +the same contents of @str, it will return a new reference, instead of +creating a new string. + + the newly created reference + counted string, or a new reference to an existing string + + + + + a NUL-terminated string + + + + + + Creates a new reference counted string and copies the contents of @str +into it, up to @len bytes. + +Since this function does not stop at nul bytes, it is the caller's +responsibility to ensure that @str has at least @len addressable bytes. + + the newly created reference counted string + + + + + a string + + + + length of @str to use, or -1 if @str is nul-terminated + + + + + + Releases a reference on a string; if it was the last reference, the +resources allocated by the string are freed as well. + + + + + + a reference counted string + + + + Checks whether @replacement is a valid replacement string (see g_regex_replace()), i.e. that all escape sequences in @@ -38110,12 +38893,12 @@ in @length. the string to escape - + - the length of @string, or -1 if @string is nul-terminated + the length of @string, in bytes, or -1 if @string is nul-terminated @@ -38307,13 +39090,13 @@ sequences. - Inserts the (@begin, @end) range at the destination pointed to by ptr. + Inserts the (@begin, @end) range at the destination pointed to by @dest. The @begin and @end iters must point into the same sequence. It is allowed for @dest to point to a different sequence than the one pointed into by @begin and @end. -If @dest is NULL, the range indicated by @begin and @end is -removed from the sequence. If @dest iter points to a place within +If @dest is %NULL, the range indicated by @begin and @end is +removed from the sequence. If @dest points to a place within the (@begin, @end) range, the range does not move. @@ -39061,6 +39844,76 @@ are different concepts on Windows. + + Identical to g_spawn_async_with_pipes() but instead of +creating pipes for the stdin/stdout/stderr, you can pass existing +file descriptors into this function through the @stdin_fd, +@stdout_fd and @stderr_fd parameters. The following @flags +also have their behaviour slightly tweaked as a result: + +%G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output +will be discarded, instead of going to the same location as the parent's +standard output. If you use this flag, @standard_output must be -1. +%G_SPAWN_STDERR_TO_DEV_NULL means that the child's standard error +will be discarded, instead of going to the same location as the parent's +standard error. If you use this flag, @standard_error must be -1. +%G_SPAWN_CHILD_INHERITS_STDIN means that the child will inherit the parent's +standard input (by default, the child's standard input is attached to +/dev/null). If you use this flag, @standard_input must be -1. + +It is valid to pass the same fd in multiple parameters (e.g. you can pass +a single fd for both stdout and stderr). + + %TRUE on success, %FALSE if an error was set + + + + + child's current working directory, or %NULL to inherit parent's, in the GLib file name encoding + + + + child's argument vector, in the GLib file name encoding + + + + + + child's environment, or %NULL to inherit parent's, in the GLib file name encoding + + + + + + flags from #GSpawnFlags + + + + function to run in the child just before exec() + + + + user data for @child_setup + + + + return location for child process ID, or %NULL + + + + file descriptor to use for child's stdin, or -1 + + + + file descriptor to use for child's stdout, or -1 + + + + file descriptor to use for child's stderr, or -1 + + + + Executes a child program asynchronously (your program will not block waiting for the child to exit). The child program is @@ -39130,10 +39983,11 @@ the %SIGCHLD signal manually. On Windows, calling g_spawn_close_pid() is equivalent to calling CloseHandle() on the process handle returned in @child_pid). See g_child_watch_add(). -%G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that the parent's open file -descriptors will be inherited by the child; otherwise all descriptors -except stdin/stdout/stderr will be closed before calling exec() in -the child. %G_SPAWN_SEARCH_PATH means that @argv[0] need not be an +Open UNIX file descriptors marked as `FD_CLOEXEC` will be automatically +closed in the child process. %G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that +other open file descriptors will be inherited by the child; otherwise all +descriptors except stdin/stdout/stderr will be closed before calling exec() +in the child. %G_SPAWN_SEARCH_PATH means that @argv[0] need not be an absolute path, it will be looked for in the `PATH` environment variable. %G_SPAWN_SEARCH_PATH_FROM_ENVP means need not be an absolute path, it will be looked for in the `PATH` variable from @@ -39208,6 +40062,21 @@ and @standard_error will not be filled with valid values. If @child_pid is not %NULL and an error does not occur then the returned process reference must be closed using g_spawn_close_pid(). +On modern UNIX platforms, GLib can use an efficient process launching +codepath driven internally by posix_spawn(). This has the advantage of +avoiding the fork-time performance costs of cloning the parent process +address space, and avoiding associated memory overcommit checks that are +not relevant in the context of immediately executing a distinct process. +This optimized codepath will be used provided that the following conditions +are met: + +1. %G_SPAWN_DO_NOT_REAP_CHILD is set +2. %G_SPAWN_LEAVE_DESCRIPTORS_OPEN is set +3. %G_SPAWN_SEARCH_PATH_FROM_ENVP is not set +4. @working_directory is %NULL +5. @child_setup is %NULL +6. The program is of a recognised binary format, or has a shebang. Otherwise, GLib will have to execute the program through the shell, which is not done using the optimized codepath. + If you are writing a GTK+ application, and the program you are spawning is a graphical application too, then to ensure that the spawned program opens its windows on the right screen, you may want to use #GdkAppLaunchContext, @@ -39544,9 +40413,9 @@ if they are equal. It can be passed to g_hash_table_new() as the @key_equal_func parameter, when using non-%NULL strings as keys in a #GHashTable. -Note that this function is primarily meant as a hash table comparison -function. For a general-purpose, %NULL-safe string comparison function, -see g_strcmp0(). +This function is typically used for hash table comparisons, but can be used +for general purpose comparisons of non-%NULL strings. For a %NULL-safe string +comparison function, see g_strcmp0(). %TRUE if the two keys match @@ -39690,12 +40559,12 @@ change by version or even by runtime environment. If the source language of @str is known, it can used to improve the accuracy of the translation by passing it as @from_locale. It should be a valid POSIX locale string (of the form -"language[_territory][.codeset][@modifier]"). +`language[_territory][.codeset][@modifier]`). If @from_locale is %NULL then the current locale is used. If you want to do translation for no specific locale, and you want it -to be done independently of the currently locale, specify "C" for +to be done independently of the currently locale, specify `"C"` for @from_locale. a string in plain ASCII @@ -40628,7 +41497,7 @@ point in some locales, causing unexpected results. Returns the length of the given %NULL-terminated -string array @str_array. +string array @str_array. @str_array must not be %NULL. length of @str_array. @@ -41093,7 +41962,13 @@ So far, the following arguments are understood: `no-undefined`: Avoid tests for undefined behaviour -- `--debug-log`: Debug test logging output. +- `--debug-log`: Debug test logging output. + +Since 2.58, if tests are compiled with `G_DISABLE_ASSERT` defined, +g_test_init() will print an error and exit. This is to prevent no-op tests +from being executed, as g_assert() is commonly (erroneously) used in unit +tests, and is a no-op when compiled with `G_DISABLE_ASSERT`. Ensure your +tests are compiled without `G_DISABLE_ASSERT` defined. @@ -41350,11 +42225,13 @@ on the order that tests are run in. If you need to ensure that some particular code runs before or after a given test case, use g_test_add(), which lets you specify setup and teardown functions. -If all tests are skipped, this function will return 0 if -producing TAP output, or 77 (treated as "skip test" by Automake) otherwise. +If all tests are skipped or marked as incomplete (expected failures), +this function will return 0 if producing TAP output, or 77 (treated +as "skip test" by Automake) otherwise. 0 on success, 1 on failure (assuming it returns at all), - 0 or 77 if all tests were skipped with g_test_skip() + 0 or 77 if all tests were skipped with g_test_skip() and/or + g_test_incomplete() @@ -41744,7 +42621,9 @@ to a #GTimeVal and puts it into @time_. @iso_date must include year, month, day, hours, minutes, and seconds. It can optionally include fractions of a second and a time zone indicator. (In the absence of any time zone indication, the -timestamp is assumed to be in local time.) +timestamp is assumed to be in local time.) + +Any leading or trailing space in @iso_date is ignored. %TRUE if the conversion was successful. @@ -41832,7 +42711,7 @@ the callback will be invoked in whichever thread is running that main context. You can do these steps manually if you need greater control or to use a custom main context. -The interval given in terms of monotonic time, not wall clock time. +The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). the ID (greater than 0) of the event source. @@ -41997,7 +42876,7 @@ executed. The scheduling granularity/accuracy of this timeout source will be in seconds. -The interval given in terms of monotonic time, not wall clock time. +The interval given is in terms of monotonic time, not wall clock time. See g_get_monotonic_time(). the newly-created timeout source @@ -44091,7 +44970,7 @@ doing anything else with it. a pointer to character data - + @@ -44142,10 +45021,10 @@ as per the aforementioned RFC. should ensure that a string is a valid D-Bus object path before passing it to g_variant_new_object_path(). -A valid object path starts with '/' followed by zero or more -sequences of characters separated by '/' characters. Each sequence -must contain only the characters "[A-Z][a-z][0-9]_". No sequence -(including the one following the final '/' character) may be empty. +A valid object path starts with `/` followed by zero or more +sequences of characters separated by `/` characters. Each sequence +must contain only the characters `[A-Z][a-z][0-9]_`. No sequence +(including the one following the final `/` character) may be empty. %TRUE if @string is a D-Bus object path diff --git a/rust-bindings/rust/gir-files/GObject-2.0.gir b/rust-bindings/rust/gir-files/GObject-2.0.gir index 0a5383bf..86abf3ee 100644 --- a/rust-bindings/rust/gir-files/GObject-2.0.gir +++ b/rust-bindings/rust/gir-files/GObject-2.0.gir @@ -2461,7 +2461,9 @@ converts between #GValue and native C types. The GObject library provides the #GCClosure type for this purpose. Bindings for other languages need marshallers which convert between #GValues and suitable representations in the runtime of the language in -order to use functions written in that languages as callbacks. +order to use functions written in that language as callbacks. Use +g_closure_set_marshal() to set the marshaller on such a custom +closure implementation. Within GObject, closures play an important role in the implementation of signals. When a signal is registered, the @@ -2760,7 +2762,7 @@ been invalidated before). an array of #GValues holding the arguments on which to invoke the callback of @closure - + @@ -2976,7 +2978,7 @@ closure, then the closure will be destroyed and freed. an array of #GValues holding the arguments on which to invoke the callback of @closure - + @@ -3357,7 +3359,7 @@ zeros before this function is called. All the fields in the GObject structure are private to the #GObject implementation and should never be accessed directly. - + Creates a new instance of a #GObject subtype and sets its properties. Construction parameters (see #G_PARAM_CONSTRUCT, #G_PARAM_CONSTRUCT_ONLY) @@ -3408,7 +3410,7 @@ which are not explicitly specified are set to their default values. - + Creates a new instance of a #GObject subtype and sets its properties using the provided arrays. Both arrays must have exactly @n_properties elements, and the names and values correspond by index. @@ -3432,7 +3434,7 @@ which are not explicitly specified are set to their default values. the names of each property to be set - + @@ -4267,7 +4269,7 @@ properties are passed in. the names of each property to get - + @@ -4753,7 +4755,7 @@ properties are passed in. the names of each property to be set - + @@ -4955,11 +4957,17 @@ Use #GWeakRef if thread-safety is required. - The notify signal is emitted on an object when one of its -properties has been changed. Note that getting this signal -doesn't guarantee that the value of the property has actually -changed, it may also be emitted when the setter for the property -is called to reinstate the previous value. + The notify signal is emitted on an object when one of its properties has +its value set through g_object_set_property(), g_object_set(), et al. + +Note that getting this signal doesn’t itself guarantee that the value of +the property has actually changed. When it is emitted is determined by the +derived GObject class. If the implementor did not create the property with +%G_PARAM_EXPLICIT_NOTIFY, then any call to g_object_set_property() results +in ::notify being emitted, even if the new value is the same as the old. +If they did pass %G_PARAM_EXPLICIT_NOTIFY, then this signal is emitted only +when they explicitly call g_object_notify() or g_object_notify_by_pspec(), +and common practice is to do that only when the value has actually changed. This signal is typically used to obtain change notification for a single property, by specifying the property name as a detail in the @@ -4970,7 +4978,7 @@ g_signal_connect (text_view->buffer, "notify::paste-target-list", text_view) ]| It is important to note that you must use -[canonical][canonical-parameter-name] parameter names as +[canonical parameter names][canonical-parameter-names] as detail strings for the notify signal. @@ -6535,7 +6543,13 @@ g_param_type_register_static(). - A #GParamSpec derived structure that contains the meta data for #GVariant properties. + A #GParamSpec derived structure that contains the meta data for #GVariant properties. + +When comparing values with g_param_values_cmp(), scalar values with the same +type will be compared with g_variant_compare(). Other non-%NULL variants will +be checked for equality with g_variant_equal(), and their sort order is +otherwise undefined. %NULL is ordered before non-%NULL variants. Two %NULL +values compare equal. private #GParamSpec portion @@ -6632,7 +6646,7 @@ You may not attach these to signals created with the #G_SIGNAL_NO_HOOKS flag. the instance on which the signal was emitted, followed by the parameters of the emission. - + @@ -6762,7 +6776,7 @@ filled in by the g_signal_query() function. [param_types param_names,] gpointer data2); ]| - + @@ -6855,7 +6869,7 @@ of a toggle reference changes. See g_object_add_toggle_ref(). - + Registers a private structure for an instantiatable type. When an object is allocated, the private structures for @@ -6918,6 +6932,8 @@ my_object_get_some_field (MyObject *my_object) return priv->some_field; } ]| + Use the G_ADD_PRIVATE() macro with the `G_DEFINE_*` + family of macros to add instance private data to a type @@ -8526,7 +8542,7 @@ Get the contents of a %G_TYPE_CHAR #GValue. Get the contents of a variant #GValue. - + variant contents of @value (may be %NULL) @@ -10703,7 +10719,7 @@ pointer casts. a pointer to a #GObject reference - + @@ -12058,7 +12074,7 @@ g_signal_override_class_handler(). the argument list of the signal emission. The first element in the array is a #GValue for the instance the signal is being emitted on. The rest are any arguments to be passed to the signal. - + @@ -12317,7 +12333,7 @@ connected, in contrast to g_signal_emit() and g_signal_emit_valist(). argument list for the signal emission. The first element in the array is a #GValue for the instance the signal is being emitted on. The rest are any arguments to be passed to the signal. - + @@ -12804,7 +12820,7 @@ the marshaller for this signal. Creates a new signal. (This is usually done in the class initializer.) This is a variant of g_signal_new() that takes a C callback instead -off a class offset for the signal's class handler. This function +of a class offset for the signal's class handler. This function doesn't need a function pointer exposed in the class structure of an object definition, instead the function pointer is passed directly and can be overriden by derived classes with diff --git a/rust-bindings/rust/gir-files/Gio-2.0.gir b/rust-bindings/rust/gir-files/Gio-2.0.gir index 3dbe89f5..4d1d0c06 100644 --- a/rust-bindings/rust/gir-files/Gio-2.0.gir +++ b/rust-bindings/rust/gir-files/Gio-2.0.gir @@ -1978,7 +1978,7 @@ create_action_group (void) a pointer to the first item in an array of #GActionEntry structs - + @@ -2557,7 +2557,7 @@ the application. a list of content types. - + @@ -2972,7 +2972,7 @@ the application. a list of content types. - + @@ -3556,7 +3556,7 @@ no display name is available. a list of content types. - + @@ -4562,7 +4562,7 @@ the options with g_variant_dict_lookup(): a %NULL-terminated list of #GOptionEntrys - + @@ -6062,7 +6062,7 @@ in the value of a single environment variable. the environment strings, or %NULL if they were not sent - + @@ -6425,6 +6425,9 @@ situation. operation supports anonymous users. + + operation takes TCRYPT parameters (Since: 2.58) + This is the asynchronous version of #GInitable; it behaves the same @@ -9907,7 +9910,7 @@ 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. Similary, if a filter consumes an outgoing message, 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 @@ -10373,7 +10376,7 @@ version. - Synchronously closees @connection. The calling thread is blocked + 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. @@ -11745,7 +11748,7 @@ exists. A pointer to @num_entries #GDBusErrorEntry struct items. - + @@ -12932,7 +12935,10 @@ on a #GDBusConnection. 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(). +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. A new #GDBusMessage or %NULL if @error is set. Free with g_object_unref(). @@ -12940,7 +12946,7 @@ g_object_unref(). - A blob represent a binary D-Bus message. + A blob representing a binary D-Bus message. @@ -13012,7 +13018,7 @@ determine the size). - A blob represent a binary D-Bus message. + A blob representing a binary D-Bus message. @@ -13123,8 +13129,11 @@ empty. Do not free, it is owned by @message. - Gets a header field on @message. - + Gets a header field on @message. + +The caller is responsible for checking the type of the returned #GVariant +matches what is expected. + A #GVariant with the value if the header was found, %NULL otherwise. Do not free, it is owned by @message. @@ -15539,7 +15548,7 @@ that @manager was constructed in. - A #GVariant containing the properties that changed. + A #GVariant containing the properties that changed (type: `a{sv}`). @@ -17262,7 +17271,7 @@ This signal corresponds to the - A #GVariant containing the properties that changed + A #GVariant containing the properties that changed (type: `a{sv}`) @@ -17893,6 +17902,10 @@ case. [Extending GIO][extending-gio]. + + The string used to obtain a Unix device path with g_drive_get_identifier(). + + Data input stream implements #GInputStream and includes functions for reading structured data directly from a binary input stream. @@ -19701,8 +19714,9 @@ 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`). - - a new #GDesktopAppInfo, or %NULL if no desktop file with that id + + a new #GDesktopAppInfo, or %NULL if no desktop + file with that id exists. @@ -19714,7 +19728,7 @@ prefix-to-subdirectory mapping that is described in the Creates a new #GDesktopAppInfo. - + a new #GDesktopAppInfo or %NULL on error. @@ -19728,7 +19742,7 @@ prefix-to-subdirectory mapping that is described in the Creates a new #GDesktopAppInfo. - + a new #GDesktopAppInfo or %NULL on error. @@ -20078,11 +20092,12 @@ 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 traditional UNIX fork()/exec() -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. +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, @@ -20129,6 +20144,67 @@ activation) then @spawn_flags, @user_setup, @user_setup_data, + + 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. + + %TRUE on successful launch, %FALSE otherwise. + + + + + a #GDesktopAppInfo + + + + List of URIs + + + + + + a #GAppLaunchContext + + + + #GSpawnFlags, used for each process + + + + a #GSpawnChildSetupFunc, used once + for each process. + + + + User data for @user_setup + + + + Callback for child processes + + + + User data for @callback + + + + file descriptor to use for child's stdin, or -1 + + + + file descriptor to use for child's stdout, or -1 + + + + file descriptor to use for child's stderr, or -1 + + + + Returns the list of "additional application actions" supported on the desktop file, as per the desktop file specification. @@ -20137,7 +20213,7 @@ As per the specification, this is the list of actions that are explicitly listed in the "Actions" key of the [Desktop Entry] group. a list of strings, always non-%NULL - + @@ -20521,10 +20597,12 @@ themselves. - Gets the identifier of the given kind for @drive. - + Gets the identifier of the given kind for @drive. The only +identifier currently available is +#G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. + a newly allocated string containing the - requested identfier, or %NULL if the #GDrive + requested identifier, or %NULL if the #GDrive doesn't have this kind of identifier. @@ -20555,7 +20633,7 @@ themselves. Gets the sort key for @drive, if any. - + Sorting key for @drive or %NULL if no such key is available. @@ -21051,10 +21129,12 @@ themselves. - Gets the identifier of the given kind for @drive. - + Gets the identifier of the given kind for @drive. The only +identifier currently available is +#G_DRIVE_IDENTIFIER_KIND_UNIX_DEVICE. + a newly allocated string containing the - requested identfier, or %NULL if the #GDrive + requested identifier, or %NULL if the #GDrive doesn't have this kind of identifier. @@ -21085,7 +21165,7 @@ themselves. Gets the sort key for @drive, if any. - + Sorting key for @drive or %NULL if no such key is available. @@ -21664,9 +21744,9 @@ been pressed. - + a newly allocated string containing the - requested identfier, or %NULL if the #GDrive + requested identifier, or %NULL if the #GDrive doesn't have this kind of identifier. @@ -21928,7 +22008,7 @@ been pressed. - + Sorting key for @drive or %NULL if no such key is available. @@ -22040,7 +22120,7 @@ CA DNs. You should unref each element with g_byte_array_unref() and then the free the list with g_list_free(). - + @@ -23926,7 +24006,8 @@ This attribute is only available for UNIX file systems. Corresponding 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. This attribute is only available for UNIX file systems. +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. @@ -24725,6 +24806,11 @@ g_unlink(). 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. a new #GFile that is a duplicate @@ -25268,7 +25354,7 @@ This call does no blocking I/O. Checks to see if a file is native to the platform. -A native file s one expressed in the platform-native filename format, +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. @@ -27759,6 +27845,11 @@ g_unlink(). 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. a new #GFile that is a duplicate @@ -28413,7 +28504,7 @@ This call does no blocking I/O. Checks to see if a file is native to the platform. -A native file s one expressed in the platform-native filename format, +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. @@ -30075,7 +30166,7 @@ changed the next time it is saved over. a string containing the new contents for @file - + @@ -30138,7 +30229,7 @@ contents (without copying) for the duration of the call. string of contents to replace the file with - + @@ -36001,7 +36092,7 @@ types for the given @name_space, or %NULL on error. Sets the @attribute to contain the given value, if possible. To unset the -attribute, use %G_ATTRIBUTE_TYPE_INVALID for @type. +attribute, use %G_FILE_ATTRIBUTE_TYPE_INVALID for @type. @@ -39537,8 +39628,8 @@ in the following two cases 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, the encoding is - simply the name (such as `network-server`). +- If @icon is a #GThemedIcon with exactly one name and no fallbacks, + the encoding is simply the name (such as `network-server`). An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -39608,8 +39699,8 @@ in the following two cases 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, the encoding is - simply the name (such as `network-server`). +- If @icon is a #GThemedIcon with exactly one name and no fallbacks, + the encoding is simply the name (such as `network-server`). An allocated NUL-terminated UTF8 string or %NULL if @icon can't be serialized. Use g_free() to free. @@ -39759,7 +39850,7 @@ for @family. raw address data - + @@ -45221,8 +45312,9 @@ the home directory, or the root of the volume). This is a convenience method for getting the #GVolume and then using that object to get the #GDrive. - - a #GDrive or %NULL if @mount is not associated with a volume or a drive. + + 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. @@ -45281,7 +45373,7 @@ using that object to get the #GDrive. Gets the sort key for @mount, if any. - + Sorting key for @mount or %NULL if no such key is available. @@ -45312,8 +45404,9 @@ using that object to get the #GDrive. the file system UUID for the mount in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - - the UUID for @mount or %NULL if no UUID can be computed. + + 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. @@ -45327,8 +45420,9 @@ available. Gets the volume for the @mount. - - a #GVolume or %NULL if @mount is not associated with a volume. + + 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. @@ -45769,8 +45863,9 @@ the home directory, or the root of the volume). This is a convenience method for getting the #GVolume and then using that object to get the #GDrive. - - a #GDrive or %NULL if @mount is not associated with a volume or a drive. + + 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. @@ -45829,7 +45924,7 @@ using that object to get the #GDrive. Gets the sort key for @mount, if any. - + Sorting key for @mount or %NULL if no such key is available. @@ -45860,8 +45955,9 @@ using that object to get the #GDrive. the file system UUID for the mount in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - - the UUID for @mount or %NULL if no UUID can be computed. + + 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. @@ -45875,8 +45971,9 @@ available. Gets the volume for the @mount. - - a #GVolume or %NULL if @mount is not associated with a volume. + + 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. @@ -46317,8 +46414,9 @@ finalized. - - the UUID for @mount or %NULL if no UUID can be computed. + + 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. @@ -46333,8 +46431,9 @@ finalized. - - a #GVolume or %NULL if @mount is not associated with a volume. + + 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. @@ -46349,8 +46448,9 @@ finalized. - - a #GDrive or %NULL if @mount is not associated with a volume or a drive. + + 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. @@ -46748,7 +46848,7 @@ finalized. - + Sorting key for @mount or %NULL if no such key is available. @@ -46798,7 +46898,13 @@ 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. +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. Creates a new mount operation. @@ -46850,7 +46956,7 @@ passed, see each method taking a #GMountOperation for details. - + @@ -46889,7 +46995,7 @@ passed, see each method taking a #GMountOperation for details. - + @@ -46955,6 +47061,34 @@ the choice's list, or %0. + + Check to see whether the mount operation is being used +for a TCRYPT hidden volume. + + %TRUE if mount operation is for hidden volume. + + + + + a #GMountOperation. + + + + + + Check to see whether the mount operation is being used +for a TCRYPT system volume. + + %TRUE if mount operation is for system volume. + + + + + a #GMountOperation. + + + + Gets a password from the mount operation. @@ -46981,6 +47115,19 @@ the choice's list, or %0. + + Gets a PIM from the mount operation. + + The VeraCrypt PIM within @op. + + + + + a #GMountOperation. + + + + Get the user name from the mount operation. @@ -47058,6 +47205,38 @@ the choice's list, or %0. + + Sets the mount operation to use a hidden volume if @hidden_volume is %TRUE. + + + + + + a #GMountOperation. + + + + boolean value. + + + + + + Sets the mount operation to use a system volume if @system_volume is %TRUE. + + + + + + a #GMountOperation. + + + + boolean value. + + + + Sets the mount operation's password to @password. @@ -47090,6 +47269,22 @@ the choice's list, or %0. + + Sets the mount operation's PIM to @pim. + + + + + + a #GMountOperation. + + + + an unsigned integer. + + + + Sets the user name within @op to @username. @@ -47119,6 +47314,19 @@ mount operation. See the #GMountOperation::ask-question signal. The domain to use for the mount operation. + + Whether the device to be unlocked is a TCRYPT hidden volume. +See https://www.veracrypt.fr/en/Hidden%20Volume.html. + + + + 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 +https://www.veracrypt.fr/en/System%20Encryption.html. + + The password that is used for authentication when carrying out the mount operation. @@ -47128,6 +47336,11 @@ the mount operation. Determines if and how the password information should be saved. + + The VeraCrypt PIM value, when unlocking a VeraCrypt volume. See +https://www.veracrypt.fr/en/Personal%20Iterations%20Multiplier%20(PIM).html. + + The user name that is used for authentication when carrying out the mount operation. @@ -47328,7 +47541,7 @@ primary text in a #GtkMessageDialog. - + @@ -47382,7 +47595,7 @@ primary text in a #GtkMessageDialog. - + @@ -54107,7 +54320,9 @@ 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. +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. a new #GResource, or %NULL on error @@ -54303,7 +54518,12 @@ thread. 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(). +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. a new #GResource, or %NULL on error @@ -55924,8 +56144,7 @@ The list is exactly the list of strings for which it is not an error to call g_settings_get_child(). For GSettings objects that are lists, this value can change at any -time and you should connect to the "children-changed" signal to watch -for those changes. Note that there is a race condition here: you may +time. Note that there is a race condition here: you may request a child after listing it only for it to have been destroyed in the meantime. For this reason, g_settings_get_child() may return %NULL even for a child that was listed by this function. @@ -56285,7 +56504,7 @@ having an array of strings type in the schema for @settings. the value to set it to, or %NULL - + @@ -56582,7 +56801,7 @@ g_free(). You should not attempt to free or unref the contents of the location to save the relative keys - + @@ -56853,7 +57072,7 @@ keys that were changed) but this is not strictly required. the %NULL-terminated list of changed keys - + @@ -57745,6 +57964,9 @@ 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 @@ -57902,7 +58124,8 @@ See also #GtkAction. Creates a new action. -The created action is stateless. See g_simple_action_new_stateful(). +The created action is stateless. See g_simple_action_new_stateful() to create +an action that has state. a new #GSimpleAction @@ -57913,7 +58136,8 @@ The created action is stateless. See g_simple_action_new_stateful(). - the type of parameter to the activate function + the type of parameter that will be passed to + handlers for the #GSimpleAction::activate signal, or %NULL for no parameter @@ -57921,10 +58145,10 @@ The created action is stateless. See g_simple_action_new_stateful(). Creates a new stateful action. -@state is the initial state of the action. All future state values -must have the same #GVariantType as the initial state. +All future state values must have the same #GVariantType as the initial +@state. -If the @state GVariant is floating, it is consumed. +If the @state #GVariant is floating, it is consumed. a new #GSimpleAction @@ -57935,7 +58159,8 @@ If the @state GVariant is floating, it is consumed. - the type of the parameter to the activate function + the type of the parameter that will be passed to + handlers for the #GSimpleAction::activate signal, or %NULL for no parameter @@ -58039,8 +58264,9 @@ action is stateless. Indicates that the action was just activated. -@parameter will always be of the expected type. In the event that -an incorrect type was given, no signal will be emitted. +@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 @@ -58054,7 +58280,8 @@ of #GSimpleAction to connect only one handler or the other. - the parameter to the activation + the parameter to the activation, or %NULL if it has + no parameter @@ -58063,8 +58290,10 @@ of #GSimpleAction to connect only one handler or the other. Indicates that the action just received a request to change its state. -@value will always be of the correct state type. In the event that -an incorrect type was given, no signal will be emitted. +@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 @@ -58129,7 +58358,7 @@ and adding them to the action group. a pointer to the first item in an array of #GActionEntry structs - + @@ -60433,7 +60662,7 @@ on error the buffer containing the data to send. - + @@ -60620,7 +60849,7 @@ on error the buffer containing the data to send. - + @@ -60651,7 +60880,7 @@ on error the buffer containing the data to send. - + @@ -63299,9 +63528,16 @@ if available.) 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 subclass of #GSocketListener -that makes this even easier. +and #GThreadedSocketService which are subclasses of #GSocketListener +that make this even easier. Creates a new #GSocketListener with no sockets to listen for. New listeners can be added with e.g. g_socket_listener_add_address() @@ -63519,7 +63755,11 @@ 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. +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. %TRUE on success, %FALSE on error. @@ -63585,7 +63825,11 @@ 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. +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. %TRUE on success, %FALSE on error. @@ -64410,7 +64654,7 @@ The argument list is expected to be %NULL-terminated. commandline arguments for the subprocess - + @@ -65353,7 +65597,7 @@ On Windows, they should be in UTF-8. Command line arguments - + @@ -65545,7 +65789,7 @@ function in the 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 -can use g_task_propagate_pointer() or the like to extract the +use g_task_propagate_pointer() or the like to extract the return value. Here is an example for using GTask as a GAsyncResult: @@ -67912,7 +68156,7 @@ as appropriate.) This property and the #GTlsCertificate:certificate-pem property represent the same data, just in different forms. - + @@ -67939,7 +68183,7 @@ 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. - + @@ -68126,7 +68370,7 @@ CA DNs. You should unref each element with g_byte_array_unref() and then the free the list with g_list_free(). - + @@ -68202,14 +68446,19 @@ performing %G_TLS_CERTIFICATE_BAD_IDENTITY validation, if enabled. - 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. This can -be used when talking to broken TLS servers that exhibit protocol -version intolerance. + 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. -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. SSL 3.0 is insecure, and this function does not generally enable or disable it, despite its name. @@ -68276,14 +68525,7 @@ virtual hosts. 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. This can be used when talking to servers that don't -implement version negotiation correctly and therefore refuse to -handshake at all with a modern TLS handshake. - -Despite the property name, the fallback version is usually not -SSL 3.0, because SSL 3.0 is generally disabled by the #GTlsBackend. -#GTlsClientConnection will use the next-highest available version -as the fallback version. +to use. See g_tls_client_connection_set_use_ssl3(). SSL 3.0 is insecure, and this property does not generally enable or disable it, despite its name. @@ -68362,7 +68604,10 @@ 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. However, you may call g_tls_connection_handshake() later on to -renegotiate parameters (encryption methods, etc) with the client. +rehandshake, if TLS 1.2 or older is in use. With TLS 1.3, the +behavior is undefined but guaranteed to be reasonable and +nondestructive, so most older code should be expected to continue to +work without changes. #GTlsConnection::accept_certificate may be emitted during the handshake. @@ -68589,7 +68834,10 @@ 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. However, you may call g_tls_connection_handshake() later on to -renegotiate parameters (encryption methods, etc) with the client. +rehandshake, if TLS 1.2 or older is in use. With TLS 1.3, the +behavior is undefined but guaranteed to be reasonable and +nondestructive, so most older code should be expected to continue to +work without changes. #GTlsConnection::accept_certificate may be emitted during the handshake. @@ -68734,7 +68982,8 @@ should occur for this connection. - Sets how @conn behaves with respect to rehandshaking requests. + 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, @@ -71398,7 +71647,7 @@ considered part of the password in this case.) the new password value - + @@ -71961,7 +72210,7 @@ If @n_fds is -1 then @fds must be terminated with -1. the initial list of file descriptors - + @@ -72059,7 +72308,7 @@ descriptors contained in @list, an empty array is returned. an array of file descriptors - + @@ -72876,7 +73125,7 @@ use g_unix_socket_address_new_abstract(). the abstract name - + @@ -72925,7 +73174,7 @@ its listening socket. the name - + @@ -73021,7 +73270,7 @@ abstract addresses. - + @@ -73086,8 +73335,9 @@ file chooser can use this information to show `network` volumes under a "Network" heading and `device` volumes under a "Devices" heading. - + The string used to obtain a Hal UDI with g_volume_get_identifier(). + Do not use, HAL is deprecated. @@ -73823,7 +74073,7 @@ 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_HAL_UDI, #G_VOLUME_IDENTIFIER_KIND_LABEL, etc. +#G_VOLUME_IDENTIFIER_KIND_UUID, #G_VOLUME_IDENTIFIER_KIND_LABEL, etc. Use g_volume_get_identifier() to obtain an identifier for a volume. @@ -74029,7 +74279,7 @@ g_mount_is_shadowed() for more details. Gets the drive for the @volume. - + 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. @@ -74061,9 +74311,9 @@ g_mount_is_shadowed() for more details. Gets the identifier of the given kind for @volume. See the [introduction][volume-identifier] for more information about volume identifiers. - + a newly allocated string containing the - requested identfier, or %NULL if the #GVolume + requested identifier, or %NULL if the #GVolume doesn't have this kind of identifier @@ -74080,7 +74330,7 @@ information about volume identifiers. Gets the mount for the @volume. - + a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() when no longer needed. @@ -74109,7 +74359,7 @@ information about volume identifiers. Gets the sort key for @volume, if any. - + Sorting key for @volume or %NULL if no such key is available @@ -74140,8 +74390,9 @@ information about volume identifiers. the file system UUID for the volume in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - - the UUID for @volume or %NULL if no UUID can be computed. + + 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. @@ -74420,7 +74671,7 @@ g_mount_is_shadowed() for more details. Gets the drive for the @volume. - + 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. @@ -74452,9 +74703,9 @@ g_mount_is_shadowed() for more details. Gets the identifier of the given kind for @volume. See the [introduction][volume-identifier] for more information about volume identifiers. - + a newly allocated string containing the - requested identfier, or %NULL if the #GVolume + requested identifier, or %NULL if the #GVolume doesn't have this kind of identifier @@ -74471,7 +74722,7 @@ information about volume identifiers. Gets the mount for the @volume. - + a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() when no longer needed. @@ -74500,7 +74751,7 @@ information about volume identifiers. Gets the sort key for @volume, if any. - + Sorting key for @volume or %NULL if no such key is available @@ -74531,8 +74782,9 @@ information about volume identifiers. the file system UUID for the volume in question and should be considered an opaque string. Returns %NULL if there is no UUID available. - - the UUID for @volume or %NULL if no UUID can be computed. + + 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. @@ -74692,8 +74944,9 @@ release them so the object can be finalized. - - the UUID for @volume or %NULL if no UUID can be computed. + + 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. @@ -74708,7 +74961,7 @@ release them so the object can be finalized. - + 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. @@ -74724,7 +74977,7 @@ release them so the object can be finalized. - + a #GMount or %NULL if @volume isn't mounted. The returned object should be unreffed with g_object_unref() when no longer needed. @@ -74866,9 +75119,9 @@ release them so the object can be finalized. - + a newly allocated string containing the - requested identfier, or %NULL if the #GVolume + requested identifier, or %NULL if the #GVolume doesn't have this kind of identifier @@ -74984,7 +75237,7 @@ release them so the object can be finalized. - + Sorting key for @volume or %NULL if no such key is available @@ -75034,7 +75287,7 @@ 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 -Similary, if implementing g_volume_monitor_adopt_orphan_mount(), +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 @@ -76966,8 +77219,8 @@ specification for more on the generic icon name. Gets the mime type for the content type, if one is registered. - the registered mime type for the given @type, - or %NULL if unknown. + the registered mime type for the + given @type, or %NULL if unknown; free with g_free(). @@ -77008,7 +77261,7 @@ on the other argument. a stream of data, or %NULL - + @@ -77404,7 +77657,7 @@ exists. A pointer to @num_entries #GDBusErrorEntry struct items. - + @@ -78442,7 +78695,12 @@ specified protocol. 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(). +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. a new #GResource, or %NULL on error @@ -78970,6 +79228,24 @@ if the mounts have changed since with g_unix_mounts_changed_since(). + + 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. + + a string containing the options, or %NULL if not +available. + + + + + a #GUnixMountEntry. + + + + Guesses whether a Unix mount can be ejected. diff --git a/rust-bindings/rust/src/auto/async_progress.rs b/rust-bindings/rust/src/auto/async_progress.rs index c441b5c8..ea95a329 100644 --- a/rust-bindings/rust/src/auto/async_progress.rs +++ b/rust-bindings/rust/src/auto/async_progress.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/collection_ref.rs b/rust-bindings/rust/src/auto/collection_ref.rs index b5232bb2..892d1418 100644 --- a/rust-bindings/rust/src/auto/collection_ref.rs +++ b/rust-bindings/rust/src/auto/collection_ref.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/constants.rs b/rust-bindings/rust/src/auto/constants.rs index a3031f56..a215cb26 100644 --- a/rust-bindings/rust/src/auto/constants.rs +++ b/rust-bindings/rust/src/auto/constants.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/enums.rs b/rust-bindings/rust/src/auto/enums.rs index ef22ad0a..03bdfe7b 100644 --- a/rust-bindings/rust/src/auto/enums.rs +++ b/rust-bindings/rust/src/auto/enums.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/flags.rs b/rust-bindings/rust/src/auto/flags.rs index 6e820f46..407d630e 100644 --- a/rust-bindings/rust/src/auto/flags.rs +++ b/rust-bindings/rust/src/auto/flags.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/functions.rs b/rust-bindings/rust/src/auto/functions.rs index df0af991..52017ed6 100644 --- a/rust-bindings/rust/src/auto/functions.rs +++ b/rust-bindings/rust/src/auto/functions.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use Error; diff --git a/rust-bindings/rust/src/auto/gpg_verify_result.rs b/rust-bindings/rust/src/auto/gpg_verify_result.rs index ec3e07c6..d6d479d2 100644 --- a/rust-bindings/rust/src/auto/gpg_verify_result.rs +++ b/rust-bindings/rust/src/auto/gpg_verify_result.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use Error; diff --git a/rust-bindings/rust/src/auto/mod.rs b/rust-bindings/rust/src/auto/mod.rs index 969ec25b..18ffe462 100644 --- a/rust-bindings/rust/src/auto/mod.rs +++ b/rust-bindings/rust/src/auto/mod.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT mod async_progress; diff --git a/rust-bindings/rust/src/auto/mutable_tree.rs b/rust-bindings/rust/src/auto/mutable_tree.rs index 3e6cb5e2..b7c49668 100644 --- a/rust-bindings/rust/src/auto/mutable_tree.rs +++ b/rust-bindings/rust/src/auto/mutable_tree.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use Error; diff --git a/rust-bindings/rust/src/auto/remote.rs b/rust-bindings/rust/src/auto/remote.rs index 520f1cee..c887c456 100644 --- a/rust-bindings/rust/src/auto/remote.rs +++ b/rust-bindings/rust/src/auto/remote.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/repo.rs b/rust-bindings/rust/src/auto/repo.rs index d7bdd3da..02cbd47d 100644 --- a/rust-bindings/rust/src/auto/repo.rs +++ b/rust-bindings/rust/src/auto/repo.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use AsyncProgress; @@ -94,11 +94,11 @@ impl Repo { //} //#[cfg(any(feature = "v2018_5", feature = "dox"))] - //pub fn traverse_new_parents() -> /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 } { + //pub fn traverse_new_parents() -> /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 } { // unsafe { TODO: call ffi::ostree_repo_traverse_new_parents() } //} - //pub fn traverse_new_reachable() -> /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 } { + //pub fn traverse_new_reachable() -> /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 } { // unsafe { TODO: call ffi::ostree_repo_traverse_new_reachable() } //} @@ -180,9 +180,9 @@ pub trait RepoExt { //#[cfg(any(feature = "v2018_6", feature = "dox"))] //fn list_collection_refs<'a, 'b, P: Into>, Q: Into>>(&self, match_collection_id: P, out_all_refs: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 1, id: 0 }/TypeId { ns_id: 0, id: 28 }, flags: RepoListRefsExtFlags, cancellable: Q) -> Result<(), Error>; - //fn list_commit_objects_starting_with<'a, P: Into>>(&self, start: &str, out_commits: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error>; + //fn list_commit_objects_starting_with<'a, P: Into>>(&self, start: &str, out_commits: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error>; - //fn list_objects<'a, P: Into>>(&self, flags: /*Ignored*/RepoListObjectsFlags, out_objects: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error>; + //fn list_objects<'a, P: Into>>(&self, flags: /*Ignored*/RepoListObjectsFlags, out_objects: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error>; //fn list_refs<'a, 'b, P: Into>, Q: Into>>(&self, refspec_prefix: P, out_all_refs: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 0, id: 28 }/TypeId { ns_id: 0, id: 28 }, cancellable: Q) -> Result<(), Error>; @@ -294,7 +294,7 @@ pub trait RepoExt { fn transaction_set_refspec<'a, P: Into>>(&self, refspec: &str, checksum: P); - //fn traverse_commit<'a, P: Into>>(&self, commit_checksum: &str, maxdepth: i32, out_reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error>; + //fn traverse_commit<'a, P: Into>>(&self, commit_checksum: &str, maxdepth: i32, out_reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error>; //fn traverse_commit_union<'a, P: Into>>(&self, commit_checksum: &str, maxdepth: i32, inout_reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 0, id: 25 }/TypeId { ns_id: 0, id: 25 }, cancellable: P) -> Result<(), Error>; @@ -302,7 +302,7 @@ pub trait RepoExt { //fn traverse_commit_union_with_parents<'a, P: Into>>(&self, commit_checksum: &str, maxdepth: i32, inout_reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 0, id: 25 }/TypeId { ns_id: 0, id: 25 }, inout_parents: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 0, id: 25 }/TypeId { ns_id: 0, id: 25 }, cancellable: P) -> Result<(), Error>; //#[cfg(any(feature = "v2018_6", feature = "dox"))] - //fn traverse_reachable_refs<'a, P: Into>>(&self, depth: u32, reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error>; + //fn traverse_reachable_refs<'a, P: Into>>(&self, depth: u32, reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error>; fn verify_commit<'a, 'b, 'c, P: IsA + 'a, Q: Into>, R: IsA + 'b, S: Into>, T: Into>>(&self, commit_checksum: &str, keyringdir: Q, extra_keyring: S, cancellable: T) -> Result<(), Error>; @@ -614,11 +614,11 @@ impl + IsA> RepoExt for O { // unsafe { TODO: call ffi::ostree_repo_list_collection_refs() } //} - //fn list_commit_objects_starting_with<'a, P: Into>>(&self, start: &str, out_commits: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error> { + //fn list_commit_objects_starting_with<'a, P: Into>>(&self, start: &str, out_commits: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error> { // unsafe { TODO: call ffi::ostree_repo_list_commit_objects_starting_with() } //} - //fn list_objects<'a, P: Into>>(&self, flags: /*Ignored*/RepoListObjectsFlags, out_objects: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error> { + //fn list_objects<'a, P: Into>>(&self, flags: /*Ignored*/RepoListObjectsFlags, out_objects: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error> { // unsafe { TODO: call ffi::ostree_repo_list_objects() } //} @@ -1137,7 +1137,7 @@ impl + IsA> RepoExt for O { } } - //fn traverse_commit<'a, P: Into>>(&self, commit_checksum: &str, maxdepth: i32, out_reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error> { + //fn traverse_commit<'a, P: Into>>(&self, commit_checksum: &str, maxdepth: i32, out_reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error> { // unsafe { TODO: call ffi::ostree_repo_traverse_commit() } //} @@ -1151,7 +1151,7 @@ impl + IsA> RepoExt for O { //} //#[cfg(any(feature = "v2018_6", feature = "dox"))] - //fn traverse_reachable_refs<'a, P: Into>>(&self, depth: u32, reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 181 }/TypeId { ns_id: 2, id: 181 }, cancellable: P) -> Result<(), Error> { + //fn traverse_reachable_refs<'a, P: Into>>(&self, depth: u32, reachable: /*Unknown conversion*//*Unimplemented*/HashTable TypeId { ns_id: 2, id: 182 }/TypeId { ns_id: 2, id: 182 }, cancellable: P) -> Result<(), Error> { // unsafe { TODO: call ffi::ostree_repo_traverse_reachable_refs() } //} diff --git a/rust-bindings/rust/src/auto/repo_commit_modifier.rs b/rust-bindings/rust/src/auto/repo_commit_modifier.rs index 1b7dac28..e4c02fc6 100644 --- a/rust-bindings/rust/src/auto/repo_commit_modifier.rs +++ b/rust-bindings/rust/src/auto/repo_commit_modifier.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT #[cfg(any(feature = "v2017_13", feature = "dox"))] diff --git a/rust-bindings/rust/src/auto/repo_dev_ino_cache.rs b/rust-bindings/rust/src/auto/repo_dev_ino_cache.rs index b12c3fd1..94c5a3b0 100644 --- a/rust-bindings/rust/src/auto/repo_dev_ino_cache.rs +++ b/rust-bindings/rust/src/auto/repo_dev_ino_cache.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/repo_file.rs b/rust-bindings/rust/src/auto/repo_file.rs index de648236..bdfc9796 100644 --- a/rust-bindings/rust/src/auto/repo_file.rs +++ b/rust-bindings/rust/src/auto/repo_file.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use Error; diff --git a/rust-bindings/rust/src/auto/repo_transaction_stats.rs b/rust-bindings/rust/src/auto/repo_transaction_stats.rs index 11369672..5f94acf3 100644 --- a/rust-bindings/rust/src/auto/repo_transaction_stats.rs +++ b/rust-bindings/rust/src/auto/repo_transaction_stats.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use ffi; diff --git a/rust-bindings/rust/src/auto/se_policy.rs b/rust-bindings/rust/src/auto/se_policy.rs index 11b5b681..f801e478 100644 --- a/rust-bindings/rust/src/auto/se_policy.rs +++ b/rust-bindings/rust/src/auto/se_policy.rs @@ -1,5 +1,5 @@ -// This file was generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) -// from gir-files (https://github.com/gtk-rs/gir-files @ ???) +// This file was generated by gir (https://github.com/gtk-rs/gir) +// from gir-files (https://github.com/gtk-rs/gir-files) // DO NOT EDIT use Error; diff --git a/rust-bindings/rust/src/auto/versions.txt b/rust-bindings/rust/src/auto/versions.txt new file mode 100644 index 00000000..1e3acbd1 --- /dev/null +++ b/rust-bindings/rust/src/auto/versions.txt @@ -0,0 +1,2 @@ +Generated by gir (https://github.com/gtk-rs/gir @ ffda6f9) +from gir-files (https://github.com/gtk-rs/gir-files @ ???)