diff --git a/Makefile-tests.am b/Makefile-tests.am index 97a71d0d..85995aa6 100644 --- a/Makefile-tests.am +++ b/Makefile-tests.am @@ -94,6 +94,7 @@ _installed_or_uninstalled_test_scripts = \ tests/test-gpg-signed-commit.sh \ tests/test-admin-upgrade-unconfigured.sh \ tests/test-admin-upgrade-endoflife.sh \ + tests/test-admin-upgrade-systemd-update.sh \ tests/test-admin-deploy-syslinux.sh \ tests/test-admin-deploy-2.sh \ tests/test-admin-deploy-karg.sh \ diff --git a/Makefile.in b/Makefile.in index edab772c..a716bf07 100644 --- a/Makefile.in +++ b/Makefile.in @@ -1701,6 +1701,7 @@ am__EXEEXT_23 = tests/test-basic.sh tests/test-basic-user.sh \ tests/test-gpg-signed-commit.sh \ tests/test-admin-upgrade-unconfigured.sh \ tests/test-admin-upgrade-endoflife.sh \ + tests/test-admin-upgrade-systemd-update.sh \ tests/test-admin-deploy-syslinux.sh \ tests/test-admin-deploy-2.sh tests/test-admin-deploy-karg.sh \ tests/test-admin-deploy-switch.sh \ @@ -1997,7 +1998,6 @@ pdfdir = @pdfdir@ prefix = @prefix@ program_transform_name = @program_transform_name@ psdir = @psdir@ -runstatedir = @runstatedir@ rustc = @rustc@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ @@ -2558,6 +2558,7 @@ _installed_or_uninstalled_test_scripts = tests/test-basic.sh \ tests/test-gpg-signed-commit.sh \ tests/test-admin-upgrade-unconfigured.sh \ tests/test-admin-upgrade-endoflife.sh \ + tests/test-admin-upgrade-systemd-update.sh \ tests/test-admin-deploy-syslinux.sh \ tests/test-admin-deploy-2.sh tests/test-admin-deploy-karg.sh \ tests/test-admin-deploy-switch.sh \ @@ -7651,6 +7652,13 @@ tests/test-admin-upgrade-endoflife.sh.log: tests/test-admin-upgrade-endoflife.sh --log-file $$b.log --trs-file $$b.trs \ $(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \ "$$tst" $(AM_TESTS_FD_REDIRECT) +tests/test-admin-upgrade-systemd-update.sh.log: tests/test-admin-upgrade-systemd-update.sh + @p='tests/test-admin-upgrade-systemd-update.sh'; \ + b='tests/test-admin-upgrade-systemd-update.sh'; \ + $(am__check_pre) $(LOG_DRIVER) --test-name "$$f" \ + --log-file $$b.log --trs-file $$b.trs \ + $(am__common_driver_flags) $(AM_LOG_DRIVER_FLAGS) $(LOG_DRIVER_FLAGS) -- $(LOG_COMPILE) \ + "$$tst" $(AM_TESTS_FD_REDIRECT) tests/test-admin-deploy-syslinux.sh.log: tests/test-admin-deploy-syslinux.sh @p='tests/test-admin-deploy-syslinux.sh'; \ b='tests/test-admin-deploy-syslinux.sh'; \ diff --git a/aclocal.m4 b/aclocal.m4 index 0629a2c1..42da7a18 100644 --- a/aclocal.m4 +++ b/aclocal.m4 @@ -616,9 +616,9 @@ AC_DEFUN([GOBJECT_INTROSPECTION_REQUIRE], _GOBJECT_INTROSPECTION_CHECK_INTERNAL([$1], [require]) ]) -dnl pkg.m4 - Macros to locate and utilise pkg-config. -*- Autoconf -*- -dnl serial 11 (pkg-config-0.29) -dnl +# pkg.m4 - Macros to locate and utilise pkg-config. -*- Autoconf -*- +# serial 11 (pkg-config-0.29.1) + dnl Copyright © 2004 Scott James Remnant . dnl Copyright © 2012-2015 Dan Nicholson dnl @@ -659,7 +659,7 @@ dnl dnl See the "Since" comment for each macro you use to see what version dnl of the macros you require. m4_defun([PKG_PREREQ], -[m4_define([PKG_MACROS_VERSION], [0.29]) +[m4_define([PKG_MACROS_VERSION], [0.29.1]) m4_if(m4_version_compare(PKG_MACROS_VERSION, [$1]), -1, [m4_fatal([pkg.m4 version $1 or higher is required but ]PKG_MACROS_VERSION[ found])]) ])dnl PKG_PREREQ @@ -892,6 +892,74 @@ AS_VAR_COPY([$1], [pkg_cv_][$1]) AS_VAR_IF([$1], [""], [$5], [$4])dnl ])dnl PKG_CHECK_VAR +dnl PKG_WITH_MODULES(VARIABLE-PREFIX, MODULES, +dnl [ACTION-IF-FOUND],[ACTION-IF-NOT-FOUND], +dnl [DESCRIPTION], [DEFAULT]) +dnl ------------------------------------------ +dnl +dnl Prepare a "--with-" configure option using the lowercase +dnl [VARIABLE-PREFIX] name, merging the behaviour of AC_ARG_WITH and +dnl PKG_CHECK_MODULES in a single macro. +AC_DEFUN([PKG_WITH_MODULES], +[ +m4_pushdef([with_arg], m4_tolower([$1])) + +m4_pushdef([description], + [m4_default([$5], [build with ]with_arg[ support])]) + +m4_pushdef([def_arg], [m4_default([$6], [auto])]) +m4_pushdef([def_action_if_found], [AS_TR_SH([with_]with_arg)=yes]) +m4_pushdef([def_action_if_not_found], [AS_TR_SH([with_]with_arg)=no]) + +m4_case(def_arg, + [yes],[m4_pushdef([with_without], [--without-]with_arg)], + [m4_pushdef([with_without],[--with-]with_arg)]) + +AC_ARG_WITH(with_arg, + AS_HELP_STRING(with_without, description[ @<:@default=]def_arg[@:>@]),, + [AS_TR_SH([with_]with_arg)=def_arg]) + +AS_CASE([$AS_TR_SH([with_]with_arg)], + [yes],[PKG_CHECK_MODULES([$1],[$2],$3,$4)], + [auto],[PKG_CHECK_MODULES([$1],[$2], + [m4_n([def_action_if_found]) $3], + [m4_n([def_action_if_not_found]) $4])]) + +m4_popdef([with_arg]) +m4_popdef([description]) +m4_popdef([def_arg]) + +])dnl PKG_WITH_MODULES + +dnl PKG_HAVE_WITH_MODULES(VARIABLE-PREFIX, MODULES, +dnl [DESCRIPTION], [DEFAULT]) +dnl ----------------------------------------------- +dnl +dnl Convenience macro to trigger AM_CONDITIONAL after PKG_WITH_MODULES +dnl check._[VARIABLE-PREFIX] is exported as make variable. +AC_DEFUN([PKG_HAVE_WITH_MODULES], +[ +PKG_WITH_MODULES([$1],[$2],,,[$3],[$4]) + +AM_CONDITIONAL([HAVE_][$1], + [test "$AS_TR_SH([with_]m4_tolower([$1]))" = "yes"]) +])dnl PKG_HAVE_WITH_MODULES + +dnl PKG_HAVE_DEFINE_WITH_MODULES(VARIABLE-PREFIX, MODULES, +dnl [DESCRIPTION], [DEFAULT]) +dnl ------------------------------------------------------ +dnl +dnl Convenience macro to run AM_CONDITIONAL and AC_DEFINE after +dnl PKG_WITH_MODULES check. HAVE_[VARIABLE-PREFIX] is exported as make +dnl and preprocessor variable. +AC_DEFUN([PKG_HAVE_DEFINE_WITH_MODULES], +[ +PKG_HAVE_WITH_MODULES([$1],[$2],[$3],[$4]) + +AS_IF([test "$AS_TR_SH([with_]m4_tolower([$1]))" = "yes"], + [AC_DEFINE([HAVE_][$1], 1, [Enable ]m4_tolower([$1])[ support])]) +])dnl PKG_HAVE_DEFINE_WITH_MODULES + # Copyright (C) 2002-2017 Free Software Foundation, Inc. # # This file is free software; the Free Software Foundation diff --git a/apidoc/Makefile.in b/apidoc/Makefile.in index 25ebba07..384e65ad 100644 --- a/apidoc/Makefile.in +++ b/apidoc/Makefile.in @@ -372,7 +372,6 @@ pdfdir = @pdfdir@ prefix = @prefix@ program_transform_name = @program_transform_name@ psdir = @psdir@ -runstatedir = @runstatedir@ rustc = @rustc@ sbindir = @sbindir@ sharedstatedir = @sharedstatedir@ @@ -888,7 +887,6 @@ html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) $(expand_con for file in $(HTML_IMAGES) ; do \ test -f $(abs_srcdir)/$$file && cp $(abs_srcdir)/$$file $(abs_builddir)/html; \ test -f $(abs_builddir)/$$file && cp $(abs_builddir)/$$file $(abs_builddir)/html; \ - test -f $$file && cp $$file $(abs_builddir)/html; \ done; $(GTK_DOC_V_XREF)gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) $(AM_V_at)touch html-build.stamp diff --git a/apidoc/html/home.png b/apidoc/html/home.png index e80e202a..9346b336 100644 Binary files a/apidoc/html/home.png and b/apidoc/html/home.png differ diff --git a/apidoc/html/index.html b/apidoc/html/index.html index 9062b3fd..e4c30ecb 100644 --- a/apidoc/html/index.html +++ b/apidoc/html/index.html @@ -3,7 +3,7 @@ OSTree API references: OSTree API references - + diff --git a/apidoc/html/left-insensitive.png b/apidoc/html/left-insensitive.png index fea007e7..3269393a 100644 Binary files a/apidoc/html/left-insensitive.png and b/apidoc/html/left-insensitive.png differ diff --git a/apidoc/html/left.png b/apidoc/html/left.png index 193905fc..2abde032 100644 Binary files a/apidoc/html/left.png and b/apidoc/html/left.png differ diff --git a/apidoc/html/ostree-Core-repository-independent-functions.html b/apidoc/html/ostree-Core-repository-independent-functions.html index 0107006c..09fdbe44 100644 --- a/apidoc/html/ostree-Core-repository-independent-functions.html +++ b/apidoc/html/ostree-Core-repository-independent-functions.html @@ -3,7 +3,7 @@ Core repository-independent functions: OSTree API references - + @@ -46,7 +46,7 @@ -const GVariantType * +const GVariantType * ostree_metadata_variant_type () @@ -54,7 +54,7 @@ -gboolean +gboolean ostree_validate_checksum_string () @@ -62,7 +62,7 @@ -guchar * +guchar * ostree_checksum_to_bytes () @@ -70,7 +70,7 @@ -GVariant * +GVariant * ostree_checksum_to_bytes_v () @@ -109,14 +109,14 @@ -const guchar * +const guchar * ostree_checksum_bytes_peek () -const guchar * +const guchar * ostree_checksum_bytes_peek_validate () @@ -132,7 +132,7 @@ -guchar * +guchar * ostree_checksum_b64_to_bytes () @@ -164,7 +164,7 @@ -gboolean +gboolean ostree_validate_rev () @@ -172,7 +172,7 @@ -gboolean +gboolean ostree_validate_remote_name () @@ -180,7 +180,7 @@ -gboolean +gboolean ostree_parse_refspec () @@ -203,7 +203,7 @@ -guint +guint ostree_hash_object_name () @@ -211,7 +211,7 @@ -GVariant * +GVariant * ostree_object_name_serialize () @@ -243,7 +243,7 @@ -gboolean +gboolean ostree_content_stream_parse () @@ -251,7 +251,7 @@ -gboolean +gboolean ostree_content_file_parse () @@ -259,7 +259,7 @@ -gboolean +gboolean ostree_content_file_parse_at () @@ -267,7 +267,7 @@ -gboolean +gboolean ostree_raw_file_to_archive_z2_stream () @@ -275,7 +275,7 @@ -gboolean +gboolean ostree_raw_file_to_archive_z2_stream_with_options () @@ -283,7 +283,7 @@ -gboolean +gboolean ostree_raw_file_to_content_stream () @@ -291,7 +291,7 @@ -gboolean +gboolean ostree_break_hardlink () @@ -299,7 +299,7 @@ -gboolean +gboolean ostree_checksum_file_from_input () @@ -307,7 +307,7 @@ -gboolean +gboolean ostree_checksum_file () @@ -315,7 +315,7 @@ -gboolean +gboolean ostree_checksum_file_at () @@ -331,7 +331,7 @@ -gboolean +gboolean ostree_checksum_file_async_finish () @@ -339,7 +339,7 @@ -GVariant * +GVariant * ostree_create_directory_metadata () @@ -347,7 +347,7 @@ -gboolean +gboolean ostree_validate_structureof_objtype () @@ -355,7 +355,7 @@ -gboolean +gboolean ostree_validate_structureof_csum_v () @@ -363,7 +363,7 @@ -gboolean +gboolean ostree_validate_structureof_checksum_string () @@ -371,7 +371,7 @@ -gboolean +gboolean ostree_validate_structureof_file_mode () @@ -379,7 +379,7 @@ -gboolean +gboolean ostree_validate_structureof_commit () @@ -387,7 +387,7 @@ -gboolean +gboolean ostree_validate_structureof_dirtree () @@ -395,7 +395,7 @@ -gboolean +gboolean ostree_validate_structureof_dirmeta () @@ -403,7 +403,7 @@ -gchar * +gchar * ostree_commit_get_parent () @@ -411,7 +411,7 @@ -guint64 +guint64 ostree_commit_get_timestamp () @@ -419,7 +419,7 @@ -gchar * +gchar * ostree_commit_get_content_checksum () @@ -427,7 +427,7 @@ -gboolean +gboolean ostree_check_version () @@ -507,11 +507,11 @@

Description

These functions implement repository-independent algorithms for operating on the core OSTree data formats, such as converting -GFileInfo into a GVariant.

+GFileInfo into a GVariant.

There are 4 types of objects; file, dirmeta, tree, and commit. The last 3 are metadata, and the file object is the only content object type.

-

All metadata objects are stored as GVariant (big endian). The +

All metadata objects are stored as GVariant (big endian). The rationale for this is the same as that of the ext{2,3,4} family of filesystems; most developers will be using LE, and so it's better to continually test the BE->LE swap.

@@ -540,21 +540,21 @@ to continually test the BE->LE swap.

Returns

-

TRUE if object type is metadata

+

TRUE if object type is metadata


ostree_metadata_variant_type ()

-
const GVariantType *
+
const GVariantType *
 ostree_metadata_variant_type (OstreeObjectType objtype);

ostree_validate_checksum_string ()

-
gboolean
+
gboolean
 ostree_validate_checksum_string (const char *sha256,
-                                 GError **error);
+ GError **error);

Use this function to see if input strings are checksums.

Parameters

@@ -580,14 +580,14 @@ ostree_validate_checksum_string (const

Returns

-

TRUE if sha256 -is a valid checksum string, FALSE otherwise

+

TRUE if sha256 +is a valid checksum string, FALSE otherwise


ostree_checksum_to_bytes ()

-
guchar *
+
guchar *
 ostree_checksum_to_bytes (const char *checksum);

Parameters

@@ -607,14 +607,14 @@ ostree_checksum_to_bytes (const c

Returns

Binary checksum from checksum -of length 32; free with g_free().

+of length 32; free with g_free().

[transfer full][array fixed-size=32]


ostree_checksum_to_bytes_v ()

-
GVariant *
+
GVariant *
 ostree_checksum_to_bytes_v (const char *checksum);

Parameters

@@ -633,7 +633,7 @@ ostree_checksum_to_bytes_v (const

Returns

-

New GVariant of type ay with length 32.

+

New GVariant of type ay with length 32.

[transfer full]

@@ -641,7 +641,7 @@ ostree_checksum_to_bytes_v (const

ostree_checksum_from_bytes ()

char *
-ostree_checksum_from_bytes (const guchar *csum);
+ostree_checksum_from_bytes (const guchar *csum);

Parameters

@@ -668,7 +668,7 @@ ostree_checksum_from_bytes (const

ostree_checksum_from_bytes_v ()

char *
-ostree_checksum_from_bytes_v (GVariant *csum_v);
+ostree_checksum_from_bytes_v (GVariant *csum_v);

Parameters

@@ -679,7 +679,7 @@ ostree_checksum_from_bytes_v (

csum_v

-
+

GVariant of type ay

GVariant of type ay

 
@@ -695,7 +695,7 @@ ostree_checksum_from_bytes_v (

ostree_checksum_inplace_from_bytes ()

void
-ostree_checksum_inplace_from_bytes (const guchar *csum,
+ostree_checksum_inplace_from_bytes (const guchar *csum,
                                     char *buf);

Overwrite the contents of buf with stringified version of csum @@ -729,7 +729,7 @@ ostree_checksum_inplace_from_bytes (const

ostree_checksum_inplace_to_bytes ()

void
 ostree_checksum_inplace_to_bytes (const char *checksum,
-                                  guchar *buf);
+ guchar *buf);

Convert checksum from a string to binary in-place, without allocating memory. Use this function in hot code paths.

@@ -759,8 +759,8 @@ allocating memory. Use this function in hot code paths.


ostree_checksum_bytes_peek ()

-
const guchar *
-ostree_checksum_bytes_peek (GVariant *bytes);
+
const guchar *
+ostree_checksum_bytes_peek (GVariant *bytes);

Parameters

@@ -771,7 +771,7 @@ ostree_checksum_bytes_peek (

bytes

-
+

GVariant of type ay

GVariant of type ay

 
@@ -780,16 +780,16 @@ ostree_checksum_bytes_peek (

Returns

Binary checksum data in bytes ; do not free. If bytes -does not have the correct length, return NULL.

+does not have the correct length, return NULL.

[transfer none][array fixed-size=32][element-type guint8]


ostree_checksum_bytes_peek_validate ()

-
const guchar *
-ostree_checksum_bytes_peek_validate (GVariant *bytes,
-                                     GError **error);
+
const guchar *
+ostree_checksum_bytes_peek_validate (GVariant *bytes,
+                                     GError **error);

Like ostree_checksum_bytes_peek(), but also throws error .

@@ -803,7 +803,7 @@ ostree_checksum_bytes_peek_validate (

bytes

-

GVariant of type ay

+

GVariant of type ay

  @@ -824,7 +824,7 @@ ostree_checksum_bytes_peek_validate (

ostree_checksum_b64_from_bytes ()

char *
-ostree_checksum_b64_from_bytes (const guchar *csum);
+ostree_checksum_b64_from_bytes (const guchar *csum);

Parameters

@@ -852,7 +852,7 @@ character is used.


ostree_checksum_b64_to_bytes ()

-
guchar *
+
guchar *
 ostree_checksum_b64_to_bytes (const char *checksum);

Parameters

@@ -881,7 +881,7 @@ ostree_checksum_b64_to_bytes (const

ostree_checksum_b64_inplace_from_bytes ()

void
 ostree_checksum_b64_inplace_from_bytes
-                               (const guchar *csum,
+                               (const guchar *csum,
                                 char *buf);

Overwrite the contents of buf with modified base64 encoding of csum @@ -917,7 +917,7 @@ character is used.

ostree_checksum_b64_inplace_to_bytes ()

void
 ostree_checksum_b64_inplace_to_bytes (const char *checksum,
-                                      guint8 *buf);
+ guint8 *buf);

Overwrite the contents of buf with stringified version of csum .

@@ -949,8 +949,8 @@ ostree_checksum_b64_inplace_to_bytes (const

ostree_cmp_checksum_bytes ()

int
-ostree_cmp_checksum_bytes (const guchar *a,
-                           const guchar *b);
+ostree_cmp_checksum_bytes (const guchar *a, + const guchar *b);

Compare two binary checksums, using memcmp().

Parameters

@@ -978,9 +978,9 @@ ostree_cmp_checksum_bytes (const

ostree_validate_rev ()

-
gboolean
+
gboolean
 ostree_validate_rev (const char *rev,
-                     GError **error);
+ GError **error);

Parameters

@@ -1005,16 +1005,16 @@ ostree_validate_rev (const char

Returns

-

TRUE if rev +

TRUE if rev is a valid ref string


ostree_validate_remote_name ()

-
gboolean
+
gboolean
 ostree_validate_remote_name (const char *remote_name,
-                             GError **error);
+ GError **error);

Parameters

@@ -1039,7 +1039,7 @@ ostree_validate_remote_name (const

Returns

-

TRUE if remote_name +

TRUE if remote_name is a valid remote name

Since: 2017.8

@@ -1047,20 +1047,20 @@ is a valid remote name


ostree_parse_refspec ()

-
gboolean
+
gboolean
 ostree_parse_refspec (const char *refspec,
                       char **out_remote,
                       char **out_ref,
-                      GError **error);
+ GError **error);

Split a refspec like gnome-ostree:gnome-ostree/buildmaster or just gnome-ostree/buildmaster into two parts. In the first case, out_remote will be set to gnome-ostree, and out_ref to gnome-ostree/buildmaster. In the second case (a local ref), out_remote - will be NULL, and out_ref + will be NULL, and out_ref -will be gnome-ostree/buildmaster. In both cases, TRUE will be returned.

+will be gnome-ostree/buildmaster. In both cases, TRUE will be returned.

Parameters

@@ -1078,7 +1078,7 @@ will be gnome-ostree/buildmaster. In both cases, +or NULL if the refspec refs to a local ref.

@@ -1096,7 +1096,7 @@ or

Returns

-

TRUE on successful parsing, FALSE otherwise

+

TRUE on successful parsing, FALSE otherwise


@@ -1147,9 +1147,9 @@ ostree_object_type_from_string (const

ostree_hash_object_name ()

-
guint
-ostree_hash_object_name (gconstpointer a);
-

Use this function with GHashTable and ostree_object_name_serialize().

+
guint
+ostree_hash_object_name (gconstpointer a);
+

Use this function with GHashTable and ostree_object_name_serialize().

Parameters

out_remote

Return location for the remote name, -or NULL if the refspec refs to a local ref.

[out][nullable][optional]
@@ -1160,7 +1160,7 @@ ostree_hash_object_name (

a

-
+

A GVariant containing a serialized object

A GVariant containing a serialized object

 
@@ -1169,7 +1169,7 @@ ostree_hash_object_name (

ostree_object_name_serialize ()

-
GVariant *
+
GVariant *
 ostree_object_name_serialize (const char *checksum,
                               OstreeObjectType objtype);
@@ -1196,7 +1196,7 @@ ostree_object_name_serialize (const

Returns

-

A new floating GVariant containing checksum string and objtype.

+

A new floating GVariant containing checksum string and objtype.

[transfer floating]

@@ -1204,7 +1204,7 @@ ostree_object_name_serialize (const

ostree_object_name_deserialize ()

void
-ostree_object_name_deserialize (GVariant *variant,
+ostree_object_name_deserialize (GVariant *variant,
                                 const char **out_checksum,
                                 OstreeObjectType *out_objtype);

Reverse ostree_object_name_serialize(). Note that out_checksum @@ -1222,7 +1222,7 @@ only valid for the lifetime of variant

variant

-

A GVariant of type (su)

+

A GVariant of type (su)

  @@ -1280,7 +1280,7 @@ and a stringifed version of objtype

ostree_object_from_string ()

void
 ostree_object_from_string (const char *str,
-                           gchar **out_checksum,
+                           gchar **out_checksum,
                            OstreeObjectType *out_objtype);

Reverse ostree_object_to_string().

@@ -1314,16 +1314,16 @@ ostree_object_from_string (const

ostree_content_stream_parse ()

-
gboolean
-ostree_content_stream_parse (gboolean compressed,
-                             GInputStream *input,
-                             guint64 input_length,
-                             gboolean trusted,
-                             GInputStream **out_input,
-                             GFileInfo **out_file_info,
-                             GVariant **out_xattrs,
-                             GCancellable *cancellable,
-                             GError **error);
+
gboolean
+ostree_content_stream_parse (gboolean compressed,
+                             GInputStream *input,
+                             guint64 input_length,
+                             gboolean trusted,
+                             GInputStream **out_input,
+                             GFileInfo **out_file_info,
+                             GVariant **out_xattrs,
+                             GCancellable *cancellable,
+                             GError **error);

The reverse of ostree_raw_file_to_content_stream(); this function converts an object content stream back into components.

@@ -1352,7 +1352,7 @@ converts an object content stream back into components.

trusted

-

If TRUE, assume the content has been validated

+

If TRUE, assume the content has been validated

  @@ -1387,15 +1387,15 @@ converts an object content stream back into components.


ostree_content_file_parse ()

-
gboolean
-ostree_content_file_parse (gboolean compressed,
-                           GFile *content_path,
-                           gboolean trusted,
-                           GInputStream **out_input,
-                           GFileInfo **out_file_info,
-                           GVariant **out_xattrs,
-                           GCancellable *cancellable,
-                           GError **error);
+
gboolean
+ostree_content_file_parse (gboolean compressed,
+                           GFile *content_path,
+                           gboolean trusted,
+                           GInputStream **out_input,
+                           GFileInfo **out_file_info,
+                           GVariant **out_xattrs,
+                           GCancellable *cancellable,
+                           GError **error);

A thin wrapper for ostree_content_stream_parse(); this function converts an object content stream back into components.

@@ -1419,7 +1419,7 @@ converts an object content stream back into components.

trusted

-

If TRUE, assume the content has been validated

+

If TRUE, assume the content has been validated

  @@ -1454,16 +1454,16 @@ converts an object content stream back into components.


ostree_content_file_parse_at ()

-
gboolean
-ostree_content_file_parse_at (gboolean compressed,
+
gboolean
+ostree_content_file_parse_at (gboolean compressed,
                               int parent_dfd,
                               const char *path,
-                              gboolean trusted,
-                              GInputStream **out_input,
-                              GFileInfo **out_file_info,
-                              GVariant **out_xattrs,
-                              GCancellable *cancellable,
-                              GError **error);
+ gboolean trusted, + GInputStream **out_input, + GFileInfo **out_file_info, + GVariant **out_xattrs, + GCancellable *cancellable, + GError **error);

A thin wrapper for ostree_content_stream_parse(); this function converts an object content stream back into components.

@@ -1492,7 +1492,7 @@ converts an object content stream back into components.

trusted

-

If TRUE, assume the content has been validated

+

If TRUE, assume the content has been validated

  @@ -1527,13 +1527,13 @@ converts an object content stream back into components.


ostree_raw_file_to_archive_z2_stream ()

-
gboolean
-ostree_raw_file_to_archive_z2_stream (GInputStream *input,
-                                      GFileInfo *file_info,
-                                      GVariant *xattrs,
-                                      GInputStream **out_input,
-                                      GCancellable *cancellable,
-                                      GError **error);
+
gboolean
+ostree_raw_file_to_archive_z2_stream (GInputStream *input,
+                                      GFileInfo *file_info,
+                                      GVariant *xattrs,
+                                      GInputStream **out_input,
+                                      GCancellable *cancellable,
+                                      GError **error);

Convert from a "bare" file representation into an OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull.

@@ -1582,15 +1582,15 @@ OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull.


ostree_raw_file_to_archive_z2_stream_with_options ()

-
gboolean
+
gboolean
 ostree_raw_file_to_archive_z2_stream_with_options
-                               (GInputStream *input,
-                                GFileInfo *file_info,
-                                GVariant *xattrs,
-                                GVariant *options,
-                                GInputStream **out_input,
-                                GCancellable *cancellable,
-                                GError **error);
+ (GInputStream *input, + GFileInfo *file_info, + GVariant *xattrs, + GVariant *options, + GInputStream **out_input, + GCancellable *cancellable, + GError **error);

Like ostree_raw_file_to_archive_z2_stream(), but supports an extensible set of flags. The following flags are currently defined:

  • compression-level (i): Level of compression to use, 0–9, with 0 being @@ -1647,14 +1647,14 @@ the least compression, and <0 giving the default level (currently 6).

  • ostree_raw_file_to_content_stream ()

    -
    gboolean
    -ostree_raw_file_to_content_stream (GInputStream *input,
    -                                   GFileInfo *file_info,
    -                                   GVariant *xattrs,
    -                                   GInputStream **out_input,
    -                                   guint64 *out_length,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    +
    gboolean
    +ostree_raw_file_to_content_stream (GInputStream *input,
    +                                   GFileInfo *file_info,
    +                                   GVariant *xattrs,
    +                                   GInputStream **out_input,
    +                                   guint64 *out_length,
    +                                   GCancellable *cancellable,
    +                                   GError **error);

    Convert from a "bare" file representation into an OSTREE_OBJECT_TYPE_FILE stream. This is a fundamental operation for writing data to an OstreeRepo.

    @@ -1709,12 +1709,12 @@ for writing data to an

    ostree_break_hardlink ()

    -
    gboolean
    +
    gboolean
     ostree_break_hardlink (int dfd,
                            const char *path,
    -                       gboolean skip_xattrs,
    -                       GCancellable *cancellable,
    -                       GError **error);
    + gboolean skip_xattrs, + GCancellable *cancellable, + GError **error);

    In many cases using libostree, a program may need to "break" hardlinks by performing a copy. For example, in order to logically append to a file.

    @@ -1764,14 +1764,14 @@ care of synchronization.


    ostree_checksum_file_from_input ()

    -
    gboolean
    -ostree_checksum_file_from_input (GFileInfo *file_info,
    -                                 GVariant *xattrs,
    -                                 GInputStream *in,
    +
    gboolean
    +ostree_checksum_file_from_input (GFileInfo *file_info,
    +                                 GVariant *xattrs,
    +                                 GInputStream *in,
                                      OstreeObjectType objtype,
    -                                 guchar **out_csum,
    -                                 GCancellable *cancellable,
    -                                 GError **error);
    + guchar **out_csum, + GCancellable *cancellable, + GError **error);

    Compute the OSTree checksum for a given input.

    Parameters

    @@ -1794,7 +1794,7 @@ ostree_checksum_file_from_input (

    in

    -

    File content, should be NULL for symbolic links.

    +

    File content, should be NULL for symbolic links.

    [allow-none] @@ -1824,12 +1824,12 @@ ostree_checksum_file_from_input (

    ostree_checksum_file ()

    -
    gboolean
    -ostree_checksum_file (GFile *f,
    +
    gboolean
    +ostree_checksum_file (GFile *f,
                           OstreeObjectType objtype,
    -                      guchar **out_csum,
    -                      GCancellable *cancellable,
    -                      GError **error);
    + guchar **out_csum, + GCancellable *cancellable, + GError **error);

    Compute the OSTree checksum for a given file.

    Parameters

    @@ -1872,15 +1872,15 @@ ostree_checksum_file (

    ostree_checksum_file_at ()

    -
    gboolean
    +
    gboolean
     ostree_checksum_file_at (int dfd,
                              const char *path,
                              struct stat *stbuf,
                              OstreeObjectType objtype,
                              OstreeChecksumFlags flags,
                              char **out_checksum,
    -                         GCancellable *cancellable,
    -                         GError **error);
    + GCancellable *cancellable, + GError **error);

    Compute the OSTree checksum for a given file. This is an fd-relative version of ostree_checksum_file() which also takes flags and fills in a caller allocated buffer.

    @@ -1942,12 +1942,12 @@ allocated buffer.

    ostree_checksum_file_async ()

    void
    -ostree_checksum_file_async (GFile *f,
    +ostree_checksum_file_async (GFile *f,
                                 OstreeObjectType objtype,
                                 int io_priority,
    -                            GCancellable *cancellable,
    -                            GAsyncReadyCallback callback,
    -                            gpointer user_data);
    + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

    Asynchronously compute the OSTree checksum for a given file; complete with ostree_checksum_file_async_finish().

    @@ -1997,11 +1997,11 @@ complete with

    ostree_checksum_file_async_finish ()

    -
    gboolean
    -ostree_checksum_file_async_finish (GFile *f,
    -                                   GAsyncResult *result,
    -                                   guchar **out_csum,
    -                                   GError **error);
    +
    gboolean
    +ostree_checksum_file_async_finish (GFile *f,
    +                                   GAsyncResult *result,
    +                                   guchar **out_csum,
    +                                   GError **error);

    Finish computing the OSTree checksum for a given file; see ostree_checksum_file_async().

    @@ -2040,9 +2040,9 @@ ostree_checksum_file_async_finish (

    ostree_create_directory_metadata ()

    -
    GVariant *
    -ostree_create_directory_metadata (GFileInfo *dir_info,
    -                                  GVariant *xattrs);
    +
    GVariant *
    +ostree_create_directory_metadata (GFileInfo *dir_info,
    +                                  GVariant *xattrs);

    Parameters

    @@ -2054,7 +2054,7 @@ ostree_create_directory_metadata (

    dir_info

    -
    + @@ -2067,16 +2067,16 @@ ostree_create_directory_metadata (

    Returns

    -

    A new GVariant containing OSTREE_OBJECT_TYPE_DIR_META.

    +

    A new GVariant containing OSTREE_OBJECT_TYPE_DIR_META.

    [transfer full]


    ostree_validate_structureof_objtype ()

    -
    gboolean
    -ostree_validate_structureof_objtype (guchar objtype,
    -                                     GError **error);
    +
    gboolean
    +ostree_validate_structureof_objtype (guchar objtype,
    +                                     GError **error);

    Parameters

    a GFileInfo containing directory information

    a GFileInfo containing directory information

     
    @@ -2094,16 +2094,16 @@ ostree_validate_structureof_objtype (

    Returns

    -

    TRUE if objtype +

    TRUE if objtype represents a valid object type


    ostree_validate_structureof_csum_v ()

    -
    gboolean
    -ostree_validate_structureof_csum_v (GVariant *checksum,
    -                                    GError **error);
    +
    gboolean
    +ostree_validate_structureof_csum_v (GVariant *checksum,
    +                                    GError **error);

    Parameters

    @@ -2115,7 +2115,7 @@ ostree_validate_structureof_csum_v (

    checksum

    -
    + @@ -2128,17 +2128,17 @@ ostree_validate_structureof_csum_v (

    Returns

    -

    TRUE if checksum +

    TRUE if checksum is a valid binary SHA256 checksum


    ostree_validate_structureof_checksum_string ()

    -
    gboolean
    +
    gboolean
     ostree_validate_structureof_checksum_string
                                    (const char *checksum,
    -                                GError **error);
    + GError **error);

    Parameters

    a GVariant of type "ay"

    a GVariant of type "ay"

     
    @@ -2163,16 +2163,16 @@ ostree_validate_structureof_checksum_string

    Returns

    -

    TRUE if checksum +

    TRUE if checksum is a valid ASCII SHA256 checksum


    ostree_validate_structureof_file_mode ()

    -
    gboolean
    -ostree_validate_structureof_file_mode (guint32 mode,
    -                                       GError **error);
    +
    gboolean
    +ostree_validate_structureof_file_mode (guint32 mode,
    +                                       GError **error);

    Parameters

    @@ -2197,16 +2197,16 @@ ostree_validate_structureof_file_mode (

    Returns

    -

    TRUE if mode +

    TRUE if mode represents a valid file type and permissions


    ostree_validate_structureof_commit ()

    -
    gboolean
    -ostree_validate_structureof_commit (GVariant *commit,
    -                                    GError **error);
    +
    gboolean
    +ostree_validate_structureof_commit (GVariant *commit,
    +                                    GError **error);

    Use this to validate the basic structure of commit , independent of any other objects it references.

    @@ -2234,16 +2234,16 @@ any other objects it references.

    Returns

    -

    TRUE if commit +

    TRUE if commit is structurally valid


    ostree_validate_structureof_dirtree ()

    -
    gboolean
    -ostree_validate_structureof_dirtree (GVariant *dirtree,
    -                                     GError **error);
    +
    gboolean
    +ostree_validate_structureof_dirtree (GVariant *dirtree,
    +                                     GError **error);

    Use this to validate the basic structure of dirtree , independent of any other objects it references.

    @@ -2271,16 +2271,16 @@ any other objects it references.

    Returns

    -

    TRUE if dirtree +

    TRUE if dirtree is structurally valid


    ostree_validate_structureof_dirmeta ()

    -
    gboolean
    -ostree_validate_structureof_dirmeta (GVariant *dirmeta,
    -                                     GError **error);
    +
    gboolean
    +ostree_validate_structureof_dirmeta (GVariant *dirmeta,
    +                                     GError **error);

    Use this to validate the basic structure of dirmeta .

    @@ -2307,15 +2307,15 @@ ostree_validate_structureof_dirmeta (

    Returns

    -

    TRUE if dirmeta +

    TRUE if dirmeta is structurally valid


    ostree_commit_get_parent ()

    -
    gchar *
    -ostree_commit_get_parent (GVariant *commit_variant);
    +
    gchar *
    +ostree_commit_get_parent (GVariant *commit_variant);

    Parameters

    @@ -2334,21 +2334,21 @@ ostree_commit_get_parent (

    Returns

    Checksum of the parent commit of commit_variant -, or NULL +, or NULL if none


    ostree_commit_get_timestamp ()

    -
    guint64
    -ostree_commit_get_timestamp (GVariant *commit_variant);
    +
    guint64
    +ostree_commit_get_timestamp (GVariant *commit_variant);

    ostree_commit_get_content_checksum ()

    -
    gchar *
    -ostree_commit_get_content_checksum (GVariant *commit_variant);
    +
    gchar *
    +ostree_commit_get_content_checksum (GVariant *commit_variant);

    There are use cases where one wants a checksum just of the content of a commit. OSTree commits by default capture the current timestamp, and may have additional metadata, which means that re-committing identical content @@ -2375,7 +2375,7 @@ root "dirmeta" checksum (both in binary form, not hexadecimal).

    Returns

    -

    A SHA-256 hex string, or NULL if commit_variant +

    A SHA-256 hex string, or NULL if commit_variant is not well-formed.

    [nullable]

    @@ -2383,9 +2383,9 @@ is not well-formed.


    ostree_check_version ()

    -
    gboolean
    -ostree_check_version (guint required_year,
    -                      guint required_release);
    +
    gboolean
    +ostree_check_version (guint required_year,
    +                      guint required_release);

    Parameters

    @@ -2410,7 +2410,7 @@ ostree_check_version (

    Returns

    -

    TRUE if current libostree has at least the requested version, FALSE otherwise

    +

    TRUE if current libostree has at least the requested version, FALSE otherwise

    diff --git a/apidoc/html/ostree-GPG-signature-verification-results.html b/apidoc/html/ostree-GPG-signature-verification-results.html index 84821a72..150337e3 100644 --- a/apidoc/html/ostree-GPG-signature-verification-results.html +++ b/apidoc/html/ostree-GPG-signature-verification-results.html @@ -3,7 +3,7 @@ GPG signature verification results: OSTree API references - + @@ -41,7 +41,7 @@
    +, or NULL.

    @@ -248,22 +248,22 @@ signed by key_id

    Returns

    -

    TRUE on success, FALSE on failure

    +

    TRUE on success, FALSE on failure


    ostree_gpg_verify_result_get ()

    -
    GVariant *
    +
    GVariant *
     ostree_gpg_verify_result_get (OstreeGpgVerifyResult *result,
    -                              guint signature_index,
    +                              guint signature_index,
                                   OstreeGpgSignatureAttr *attrs,
    -                              guint n_attrs);
    -

    Builds a GVariant tuple of requested attributes for the GPG signature at + guint n_attrs);

    +

    Builds a GVariant tuple of requested attributes for the GPG signature at signature_index in result . See the OstreeGpgSignatureAttr description -for the GVariantType of each available attribute.

    +for the GVariantType of each available attribute.

    It is a programmer error to request an invalid OstreeGpgSignatureAttr or an invalid signature_index . Use ostree_gpg_verify_result_count_all() to @@ -304,29 +304,29 @@ array

    Returns

    -

    a new, floating, GVariant tuple

    +

    a new, floating, GVariant tuple


    ostree_gpg_verify_result_get_all ()

    -
    GVariant *
    +
    GVariant *
     ostree_gpg_verify_result_get_all (OstreeGpgVerifyResult *result,
    -                                  guint signature_index);
    -

    Builds a GVariant tuple of all available attributes for the GPG signature + guint signature_index);

    +

    Builds a GVariant tuple of all available attributes for the GPG signature at signature_index in result .

    -

    The child values in the returned GVariant tuple are ordered to match the +

    The child values in the returned GVariant tuple are ordered to match the OstreeGpgSignatureAttr enumeration, which means the enum values can be -used as index values in functions like g_variant_get_child(). See the -OstreeGpgSignatureAttr description for the GVariantType of each +used as index values in functions like g_variant_get_child(). See the +OstreeGpgSignatureAttr description for the GVariantType of each available attribute.

    The OstreeGpgSignatureAttr enumeration may be extended in the future - with new attributes, which would affect the GVariant tuple returned by + with new attributes, which would affect the GVariant tuple returned by this function. While the position and type of current child values in - the GVariant tuple will not change, to avoid backward-compatibility + the GVariant tuple will not change, to avoid backward-compatibility issues please do not depend on the tuple's overall size or type signature.

    @@ -359,7 +359,7 @@ available attribute.

    Returns

    -

    a new, floating, GVariant tuple

    +

    a new, floating, GVariant tuple


    @@ -367,9 +367,9 @@ available attribute.

    ostree_gpg_verify_result_describe ()

    void
     ostree_gpg_verify_result_describe (OstreeGpgVerifyResult *result,
    -                                   guint signature_index,
    -                                   GString *output_buffer,
    -                                   const gchar *line_prefix,
    +                                   guint signature_index,
    +                                   GString *output_buffer,
    +                                   const gchar *line_prefix,
                                        OstreeGpgSignatureFormatFlags flags);

    Appends a brief, human-readable description of the GPG signature at signature_index @@ -408,7 +408,7 @@ format. Currently must be 0.

    - + @@ -430,11 +430,11 @@ format. Currently must be 0.

    ostree_gpg_verify_result_describe_variant ()

    void
     ostree_gpg_verify_result_describe_variant
    -                               (GVariant *variant,
    -                                GString *output_buffer,
    -                                const gchar *line_prefix,
    +                               (GVariant *variant,
    +                                GString *output_buffer,
    +                                const gchar *line_prefix,
                                     OstreeGpgSignatureFormatFlags flags);
    -

    Similar to ostree_gpg_verify_result_describe() but takes a GVariant of +

    Similar to ostree_gpg_verify_result_describe() but takes a GVariant of all attributes for a GPG signature instead of an OstreeGpgVerifyResult and signature index.

    The variant @@ -451,12 +451,12 @@ and signature index.

    - + - + @@ -476,14 +476,14 @@ and signature index.


    ostree_gpg_verify_result_require_valid_signature ()

    -
    gboolean
    +
    gboolean
     ostree_gpg_verify_result_require_valid_signature
                                    (OstreeGpgVerifyResult *result,
    -                                GError **error);
    + GError **error);

    Checks if the result contains at least one signature from the trusted keyring. You can call this function immediately after ostree_repo_verify_summary() or ostree_repo_verify_commit_ext() - -it will handle the NULL result +it will handle the NULL result and filled error too.

    @@ -502,7 +502,7 @@ it will handle the

    error

    -
    + @@ -510,9 +510,9 @@ it will handle the

    Returns

    -

    TRUE if result -was not NULL and had at least one -signature from trusted keyring, otherwise FALSE

    +

    TRUE if result +was not NULL and had at least one +signature from trusted keyring, otherwise FALSE

    @@ -568,7 +568,7 @@ These may be returned by any API which creates or verifies signatures.

    enum OstreeGpgSignatureAttr

    Signature attributes available from an OstreeGpgVerifyResult. -The attribute's GVariantType is shown in brackets.

    +The attribute's GVariantType is shown in brackets.

    Members

    -guint +guint ostree_gpg_verify_result_count_all () @@ -49,7 +49,7 @@
    -guint +guint ostree_gpg_verify_result_count_valid () @@ -57,7 +57,7 @@
    -gboolean +gboolean ostree_gpg_verify_result_lookup () @@ -65,7 +65,7 @@
    -GVariant * +GVariant * ostree_gpg_verify_result_get () @@ -73,7 +73,7 @@
    -GVariant * +GVariant * ostree_gpg_verify_result_get_all () @@ -97,7 +97,7 @@
    -gboolean +gboolean ostree_gpg_verify_result_require_valid_signature () @@ -150,7 +150,7 @@ or get all signature details with

    Functions

    ostree_gpg_verify_result_count_all ()

    -
    guint
    +
    guint
     ostree_gpg_verify_result_count_all (OstreeGpgVerifyResult *result);

    Counts all the signatures in result .

    @@ -177,7 +177,7 @@ ostree_gpg_verify_result_count_all (

    ostree_gpg_verify_result_count_valid ()

    -
    guint
    +
    guint
     ostree_gpg_verify_result_count_valid (OstreeGpgVerifyResult *result);

    Counts only the valid signatures in result .

    @@ -204,17 +204,17 @@ ostree_gpg_verify_result_count_valid (

    ostree_gpg_verify_result_lookup ()

    -
    gboolean
    +
    gboolean
     ostree_gpg_verify_result_lookup (OstreeGpgVerifyResult *result,
    -                                 const gchar *key_id,
    -                                 guint *out_signature_index);
    + const gchar *key_id, + guint *out_signature_index);

    Searches result for a signature signed by key_id . If a match is found, -the function returns TRUE and sets out_signature_index +the function returns TRUE and sets out_signature_index so that further signature details can be obtained through ostree_gpg_verify_result_get(). -If no match is found, the function returns FALSE and leaves +If no match is found, the function returns FALSE and leaves out_signature_index unchanged.

    @@ -240,7 +240,7 @@ If no match is found, the function returns

    out_signature_index

    return location for the index of the signature signed by key_id -, or NULL.

    [out]

    output_buffer

    a GString to hold the description

    a GString to hold the description

     

    variant

    a GVariant from ostree_gpg_verify_result_get_all()

    a GVariant from ostree_gpg_verify_result_get_all()

     

    output_buffer

    a GString to hold the description

    a GString to hold the description

     

    A GError

    A GError

     
    @@ -581,56 +581,56 @@ The attribute's

    OSTREE_GPG_SIGNATURE_ATTR_VALID

    @@ -638,7 +638,7 @@ The attribute's

    OSTREE_GPG_SIGNATURE_ATTR_PUBKEY_ALGO_NAME

    @@ -646,7 +646,7 @@ The attribute's

    OSTREE_GPG_SIGNATURE_ATTR_HASH_ALGO_NAME

    @@ -654,14 +654,14 @@ The attribute's

    OSTREE_GPG_SIGNATURE_ATTR_USER_NAME

    @@ -669,7 +669,7 @@ The attribute's

    OSTREE_GPG_SIGNATURE_ATTR_FINGERPRINT_PRIMARY

    - + @@ -281,12 +281,12 @@ exist.


    ostree_mutable_tree_walk ()

    -
    gboolean
    +
    gboolean
     ostree_mutable_tree_walk (OstreeMutableTree *self,
    -                          GPtrArray *split_path,
    -                          guint start,
    +                          GPtrArray *split_path,
    +                          guint start,
                               OstreeMutableTree **out_subdir,
    -                          GError **error);
    + GError **error);

    Traverse start number of elements starting from split_path ; the @@ -334,7 +334,7 @@ child will be returned in out_subdir


    ostree_mutable_tree_get_subdirs ()

    -
    GHashTable *
    +
    GHashTable *
     ostree_mutable_tree_get_subdirs (OstreeMutableTree *self);

    Returns

    @@ -345,7 +345,7 @@ ostree_mutable_tree_get_subdirs (

    ostree_mutable_tree_get_files ()

    -
    GHashTable *
    +
    GHashTable *
     ostree_mutable_tree_get_files (OstreeMutableTree *self);

    Returns

    diff --git a/apidoc/html/ostree-OstreeRepo.html b/apidoc/html/ostree-OstreeRepo.html index 3afc1f25..abe18803 100644 --- a/apidoc/html/ostree-OstreeRepo.html +++ b/apidoc/html/ostree-OstreeRepo.html @@ -3,7 +3,7 @@ OstreeRepo: Content-addressed object store: OSTree API references - + @@ -41,7 +41,7 @@
    - + @@ -299,10 +299,10 @@ g_autofree gchar *status

    ostree_async_progress_get_variant ()

    -
    GVariant *
    +
    GVariant *
     ostree_async_progress_get_variant (OstreeAsyncProgress *self,
                                        const char *key);
    -

    Look up a key in the OstreeAsyncProgress and return the GVariant associated +

    Look up a key in the OstreeAsyncProgress and return the GVariant associated with it. The lookup is thread-safe.

    Parameters

    @@ -329,7 +329,7 @@ with it. The lookup is thread-safe.

    Returns

    value for the given key -, or NULL if +, or NULL if it was not set.

    [transfer full][nullable]

    @@ -338,14 +338,14 @@ it was not set.


    ostree_async_progress_get_uint ()

    -
    guint
    +
    guint
     ostree_async_progress_get_uint (OstreeAsyncProgress *self,
                                     const char *key);

    ostree_async_progress_get_uint64 ()

    -
    guint64
    +
    guint64
     ostree_async_progress_get_uint64 (OstreeAsyncProgress *self,
                                       const char *key);
    @@ -356,7 +356,7 @@ ostree_async_progress_get_uint64 (OstreeAsyncProgress *self, const char *status);

    Set the human-readable status string for the OstreeAsyncProgress. This -operation is thread-safe. NULL may be passed to clear the status.

    +operation is thread-safe. NULL may be passed to clear the status.

    This is a convenience function to set the well-known status key.

    Parameters

    @@ -374,7 +374,7 @@ operation is thread-safe.

    status

    -
    + @@ -389,11 +389,11 @@ operation is thread-safe. OstreeAsyncProgress *self, ...);

    Set the values for zero or more keys in the OstreeAsyncProgress. Each key is -specified in @... as the key name, followed by a GVariant format string, +specified in @... as the key name, followed by a GVariant format string, followed by the necessary arguments for that format string, just as for -g_variant_new(). After those arguments is the next key name. The varargs list -must be NULL-terminated.

    -

    g_variant_ref_sink() will be called as appropriate on the GVariant +g_variant_new(). After those arguments is the next key name. The varargs list +must be NULL-terminated.

    +

    g_variant_ref_sink() will be called as appropriate on the GVariant parameters, so they may be floating.

    This operation is thread-safe, and all the keys are set atomically.

    @@ -409,15 +409,15 @@ parameters, so they may be floating.

    7 8 9 -
    +ostree_async_progress_set (progress, + "outstanding-fetches", "u", outstanding_fetches, + "bytes-received", "t", bytes_received, + "status", "s", "Updated status", + "refs", "@a{ss}", g_variant_new_parsed ("@a{ss} {}"), + NULL);
    -

    [G_VARIANT_TYPE_BOOLEAN] Is the signature valid?

    +

    [G_VARIANT_TYPE_BOOLEAN] Is the signature valid?

     

    OSTREE_GPG_SIGNATURE_ATTR_SIG_EXPIRED

    -

    [G_VARIANT_TYPE_BOOLEAN] Has the signature expired?

    +

    [G_VARIANT_TYPE_BOOLEAN] Has the signature expired?

     

    OSTREE_GPG_SIGNATURE_ATTR_KEY_EXPIRED

    -

    [G_VARIANT_TYPE_BOOLEAN] Has the signing key expired?

    +

    [G_VARIANT_TYPE_BOOLEAN] Has the signing key expired?

     

    OSTREE_GPG_SIGNATURE_ATTR_KEY_REVOKED

    -

    [G_VARIANT_TYPE_BOOLEAN] Has the signing key been revoked?

    +

    [G_VARIANT_TYPE_BOOLEAN] Has the signing key been revoked?

     

    OSTREE_GPG_SIGNATURE_ATTR_KEY_MISSING

    -

    [G_VARIANT_TYPE_BOOLEAN] Is the signing key missing?

    +

    [G_VARIANT_TYPE_BOOLEAN] Is the signing key missing?

     

    OSTREE_GPG_SIGNATURE_ATTR_FINGERPRINT

    -

    [G_VARIANT_TYPE_STRING] Fingerprint of the signing key

    +

    [G_VARIANT_TYPE_STRING] Fingerprint of the signing key

     

    OSTREE_GPG_SIGNATURE_ATTR_TIMESTAMP

    -

    [G_VARIANT_TYPE_INT64] Signature creation Unix timestamp

    +

    [G_VARIANT_TYPE_INT64] Signature creation Unix timestamp

     

    OSTREE_GPG_SIGNATURE_ATTR_EXP_TIMESTAMP

    -

    [G_VARIANT_TYPE_INT64] Signature expiration Unix timestamp (0 if no +

    [G_VARIANT_TYPE_INT64] Signature expiration Unix timestamp (0 if no expiration)

      -

    [G_VARIANT_TYPE_STRING] Name of the public key algorithm used to create +

    [G_VARIANT_TYPE_STRING] Name of the public key algorithm used to create the signature

      -

    [G_VARIANT_TYPE_STRING] Name of the hash algorithm used to create the +

    [G_VARIANT_TYPE_STRING] Name of the hash algorithm used to create the signature

      -

    [G_VARIANT_TYPE_STRING] The name of the signing key's primary user

    +

    [G_VARIANT_TYPE_STRING] The name of the signing key's primary user

     

    OSTREE_GPG_SIGNATURE_ATTR_USER_EMAIL

    -

    [G_VARIANT_TYPE_STRING] The email address of the signing key's primary +

    [G_VARIANT_TYPE_STRING] The email address of the signing key's primary user

      -

    [G_VARIANT_TYPE_STRING] Fingerprint of the signing key's primary key +

    [G_VARIANT_TYPE_STRING] Fingerprint of the signing key's primary key (will be the same as OSTREE_GPG_SIGNATURE_ATTR_FINGERPRINT if the the signature is already from the primary key rather than a subkey, and will be the empty string if the key is missing.)

    diff --git a/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html b/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html index d90aa551..6b6e480c 100644 --- a/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html +++ b/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html @@ -3,7 +3,7 @@ In-memory modifiable filesystem tree: OSTree API references - + @@ -79,7 +79,7 @@
    -gboolean +gboolean ostree_mutable_tree_replace_file () @@ -87,7 +87,7 @@
    -gboolean +gboolean ostree_mutable_tree_ensure_dir () @@ -95,7 +95,7 @@
    -gboolean +gboolean ostree_mutable_tree_lookup () @@ -103,7 +103,7 @@
    -gboolean +gboolean ostree_mutable_tree_ensure_parent_dirs () @@ -111,7 +111,7 @@
    -gboolean +gboolean ostree_mutable_tree_walk () @@ -119,7 +119,7 @@
    -GHashTable * +GHashTable * ostree_mutable_tree_get_subdirs () @@ -127,7 +127,7 @@
    -GHashTable * +GHashTable * ostree_mutable_tree_get_files () @@ -202,41 +202,41 @@ ostree_mutable_tree_get_contents_checksum

    ostree_mutable_tree_replace_file ()

    -
    gboolean
    +
    gboolean
     ostree_mutable_tree_replace_file (OstreeMutableTree *self,
                                       const char *name,
                                       const char *checksum,
    -                                  GError **error);
    + GError **error);

    ostree_mutable_tree_ensure_dir ()

    -
    gboolean
    +
    gboolean
     ostree_mutable_tree_ensure_dir (OstreeMutableTree *self,
                                     const char *name,
                                     OstreeMutableTree **out_subdir,
    -                                GError **error);
    + GError **error);

    ostree_mutable_tree_lookup ()

    -
    gboolean
    +
    gboolean
     ostree_mutable_tree_lookup (OstreeMutableTree *self,
                                 const char *name,
                                 char **out_file_checksum,
                                 OstreeMutableTree **out_subdir,
    -                            GError **error);
    + GError **error);

    ostree_mutable_tree_ensure_parent_dirs ()

    -
    gboolean
    +
    gboolean
     ostree_mutable_tree_ensure_parent_dirs
                                    (OstreeMutableTree *self,
    -                                GPtrArray *split_path,
    +                                GPtrArray *split_path,
                                     const char *metadata_checksum,
                                     OstreeMutableTree **out_parent,
    -                                GError **error);
    + GError **error);

    Create all parent trees necessary for the given split_path to exist.

    @@ -271,7 +271,7 @@ exist.

    error

    a GError

    a GError

     
    -gboolean +gboolean ostree_repo_mode_from_string () @@ -81,7 +81,7 @@
    -gboolean +gboolean ostree_repo_open () @@ -97,7 +97,7 @@
    -gboolean +gboolean ostree_repo_get_disable_fsync () @@ -105,7 +105,7 @@
    -gboolean +gboolean ostree_repo_is_system () @@ -113,7 +113,7 @@
    -gboolean +gboolean ostree_repo_is_writable () @@ -129,7 +129,7 @@
    -gboolean +gboolean ostree_repo_create () @@ -137,7 +137,7 @@
    -GFile * +GFile * ostree_repo_get_path () @@ -153,7 +153,7 @@
    -GKeyFile * +GKeyFile * ostree_repo_get_config () @@ -169,7 +169,7 @@
    -guint +guint ostree_repo_hash () @@ -177,7 +177,7 @@
    -gboolean +gboolean ostree_repo_equal () @@ -185,7 +185,7 @@
    -GKeyFile * +GKeyFile * ostree_repo_copy_config () @@ -193,7 +193,7 @@
    -gboolean +gboolean ostree_repo_remote_add () @@ -201,7 +201,7 @@
    -gboolean +gboolean ostree_repo_remote_delete () @@ -209,7 +209,7 @@
    -gboolean +gboolean ostree_repo_remote_change () @@ -225,7 +225,7 @@
    -gboolean +gboolean ostree_repo_remote_get_url () @@ -233,7 +233,7 @@
    -gboolean +gboolean ostree_repo_remote_get_gpg_verify () @@ -241,7 +241,7 @@
    -gboolean +gboolean ostree_repo_remote_get_gpg_verify_summary () @@ -249,7 +249,7 @@
    -gboolean +gboolean ostree_repo_remote_gpg_import () @@ -257,7 +257,7 @@
    -gboolean +gboolean ostree_repo_remote_fetch_summary () @@ -265,7 +265,7 @@
    -gboolean +gboolean ostree_repo_remote_fetch_summary_with_options () @@ -273,7 +273,7 @@
    -gboolean +gboolean ostree_repo_reload_config () @@ -281,7 +281,7 @@
    -gboolean +gboolean ostree_repo_get_remote_boolean_option () @@ -289,7 +289,7 @@
    -gboolean +gboolean ostree_repo_get_remote_list_option () @@ -297,7 +297,7 @@
    -gboolean +gboolean ostree_repo_get_remote_option () @@ -313,7 +313,7 @@
    -gboolean +gboolean ostree_repo_write_config () @@ -321,7 +321,7 @@
    -gboolean +gboolean ostree_repo_scan_hardlinks () @@ -329,7 +329,7 @@
    -gboolean +gboolean ostree_repo_prepare_transaction () @@ -337,7 +337,7 @@
    -gboolean +gboolean ostree_repo_commit_transaction () @@ -345,7 +345,7 @@
    -gboolean +gboolean ostree_repo_abort_transaction () @@ -369,7 +369,7 @@
    -gboolean +gboolean ostree_repo_set_ref_immediate () @@ -377,7 +377,7 @@
    -gboolean +gboolean ostree_repo_set_alias_ref_immediate () @@ -385,7 +385,7 @@
    -gboolean +gboolean ostree_repo_set_cache_dir () @@ -393,7 +393,7 @@
    -gboolean +gboolean ostree_repo_sign_delta () @@ -401,7 +401,7 @@
    -gboolean +gboolean ostree_repo_has_object () @@ -409,7 +409,7 @@
    -gboolean +gboolean ostree_repo_mark_commit_partial () @@ -417,7 +417,7 @@
    -gboolean +gboolean ostree_repo_write_metadata () @@ -433,7 +433,7 @@
    -gboolean +gboolean ostree_repo_write_metadata_finish () @@ -441,7 +441,7 @@
    -gboolean +gboolean ostree_repo_write_content () @@ -449,7 +449,7 @@
    -gboolean +gboolean ostree_repo_write_metadata_trusted () @@ -457,7 +457,7 @@
    -gboolean +gboolean ostree_repo_write_metadata_stream_trusted () @@ -465,7 +465,7 @@
    -gboolean +gboolean ostree_repo_write_content_trusted () @@ -481,7 +481,7 @@
    -gboolean +gboolean ostree_repo_write_content_finish () @@ -489,7 +489,7 @@
    -gboolean +gboolean ostree_repo_resolve_rev () @@ -497,7 +497,7 @@
    -gboolean +gboolean ostree_repo_resolve_rev_ext () @@ -505,7 +505,7 @@
    -gboolean +gboolean ostree_repo_list_refs () @@ -513,7 +513,7 @@
    -gboolean +gboolean ostree_repo_list_refs_ext () @@ -521,7 +521,7 @@
    -gboolean +gboolean ostree_repo_remote_list_refs () @@ -529,7 +529,7 @@
    -gboolean +gboolean ostree_repo_load_variant () @@ -537,7 +537,7 @@
    -gboolean +gboolean ostree_repo_load_commit () @@ -545,7 +545,7 @@
    -gboolean +gboolean ostree_repo_load_variant_if_exists () @@ -553,7 +553,7 @@
    -gboolean +gboolean ostree_repo_load_file () @@ -561,7 +561,7 @@
    -gboolean +gboolean ostree_repo_load_object_stream () @@ -569,7 +569,7 @@
    -gboolean +gboolean ostree_repo_query_object_storage_size () @@ -577,7 +577,7 @@
    -gboolean +gboolean ostree_repo_import_object_from () @@ -585,7 +585,7 @@
    -gboolean +gboolean ostree_repo_import_object_from_with_trust () @@ -593,7 +593,7 @@
    -gboolean +gboolean ostree_repo_import_archive_to_mtree () @@ -601,7 +601,7 @@
    -gboolean +gboolean ostree_repo_export_tree_to_archive () @@ -609,7 +609,7 @@
    -gboolean +gboolean ostree_repo_delete_object () @@ -617,7 +617,7 @@
    -gboolean +gboolean ostree_repo_fsck_object () @@ -641,7 +641,7 @@
    -GVariant * +GVariant * (*OstreeRepoCommitModifierXattrCallback) () @@ -713,7 +713,7 @@
    -GType +GType ostree_repo_devino_cache_get_type () @@ -721,7 +721,7 @@
    -gboolean +gboolean ostree_repo_write_directory_to_mtree () @@ -729,7 +729,7 @@
    -gboolean +gboolean ostree_repo_write_dfd_to_mtree () @@ -737,7 +737,7 @@
    -gboolean +gboolean ostree_repo_write_archive_to_mtree () @@ -745,7 +745,7 @@
    -gboolean +gboolean ostree_repo_write_mtree () @@ -753,7 +753,7 @@
    -gboolean +gboolean ostree_repo_write_commit () @@ -761,7 +761,7 @@
    -gboolean +gboolean ostree_repo_write_commit_with_time () @@ -769,7 +769,7 @@
    -gboolean +gboolean ostree_repo_read_commit_detached_metadata () @@ -777,7 +777,7 @@
    -gboolean +gboolean ostree_repo_write_commit_detached_metadata () @@ -793,7 +793,7 @@
    -gboolean +gboolean ostree_repo_checkout_tree () @@ -801,7 +801,7 @@
    -gboolean +gboolean ostree_repo_checkout_tree_at () @@ -809,7 +809,7 @@
    -gboolean +gboolean ostree_repo_checkout_at () @@ -817,7 +817,7 @@
    -gboolean +gboolean ostree_repo_checkout_gc () @@ -825,7 +825,7 @@
    -gboolean +gboolean ostree_repo_read_commit () @@ -833,7 +833,7 @@
    -gboolean +gboolean ostree_repo_list_objects () @@ -841,7 +841,7 @@
    -gboolean +gboolean ostree_repo_list_commit_objects_starting_with () @@ -849,7 +849,7 @@
    -gboolean +gboolean ostree_repo_list_static_delta_names () @@ -857,7 +857,7 @@
    -gboolean +gboolean ostree_repo_static_delta_generate () @@ -865,7 +865,7 @@
    -gboolean +gboolean ostree_repo_static_delta_execute_offline () @@ -873,7 +873,7 @@
    -GHashTable * +GHashTable * ostree_repo_traverse_new_reachable () @@ -881,7 +881,7 @@
    -GHashTable * +GHashTable * ostree_repo_traverse_new_parents () @@ -897,7 +897,7 @@
    -gboolean +gboolean ostree_repo_traverse_commit () @@ -905,7 +905,7 @@
    -gboolean +gboolean ostree_repo_traverse_commit_union () @@ -913,7 +913,7 @@
    -gboolean +gboolean ostree_repo_traverse_commit_union_with_parents () @@ -953,7 +953,7 @@
    -gboolean +gboolean ostree_repo_commit_traverse_iter_init_commit () @@ -961,7 +961,7 @@
    -gboolean +gboolean ostree_repo_commit_traverse_iter_init_dirtree () @@ -977,7 +977,7 @@
    -gboolean +gboolean ostree_repo_prune () @@ -985,7 +985,7 @@
    -gboolean +gboolean ostree_repo_prune_static_deltas () @@ -993,7 +993,7 @@
    -gboolean +gboolean ostree_repo_traverse_reachable_refs () @@ -1001,7 +1001,7 @@
    -gboolean +gboolean ostree_repo_prune_from_reachable () @@ -1009,7 +1009,7 @@
    -gboolean +gboolean ostree_repo_pull () @@ -1017,7 +1017,7 @@
    -gboolean +gboolean ostree_repo_pull_one_dir () @@ -1025,7 +1025,7 @@
    -gboolean +gboolean ostree_repo_pull_with_options () @@ -1041,7 +1041,7 @@
    -gboolean +gboolean ostree_repo_sign_commit () @@ -1049,7 +1049,7 @@
    -gboolean +gboolean ostree_repo_append_gpg_signature () @@ -1057,7 +1057,7 @@
    -gboolean +gboolean ostree_repo_add_gpg_signature_summary () @@ -1073,7 +1073,7 @@
    -gboolean +gboolean ostree_repo_verify_commit () @@ -1105,7 +1105,7 @@
    -gboolean +gboolean ostree_repo_regenerate_summary () @@ -1251,10 +1251,10 @@ collection IDs, see ostree_validate_collection_id()

    Functions

    ostree_repo_mode_from_string ()

    -
    gboolean
    +
    gboolean
     ostree_repo_mode_from_string (const char *mode,
                                   OstreeRepoMode *out_mode,
    -                              GError **error);
    + GError **error);

    @@ -1262,8 +1262,8 @@ ostree_repo_mode_from_string (const OstreeRepo * ostree_repo_open_at (int dfd, const char *path, - GCancellable *cancellable, - GError **error); + GCancellable *cancellable, + GError **error);

    This combines ostree_repo_new() (but using fd-relative access) with ostree_repo_open(). Use this when you know you should be operating on an already extant repository. If you want to create one, use ostree_repo_create_at().

    @@ -1301,7 +1301,7 @@ already extant repository. If you want to create one, use

    ostree_repo_new ()

    OstreeRepo *
    -ostree_repo_new (GFile *path);
    +ostree_repo_new (GFile *path);

    Parameters

    @@ -1328,8 +1328,8 @@ ostree_repo_new (

    ostree_repo_new_for_sysroot_path ()

    OstreeRepo *
    -ostree_repo_new_for_sysroot_path (GFile *repo_path,
    -                                  GFile *sysroot_path);
    +ostree_repo_new_for_sysroot_path (GFile *repo_path, + GFile *sysroot_path);

    Creates a new OstreeRepo instance, taking the system root path explicitly instead of assuming "/".

    @@ -1380,17 +1380,17 @@ Otherwise use the path in the OSTREE_REPO environment variable

    ostree_repo_open ()

    -
    gboolean
    +
    gboolean
     ostree_repo_open (OstreeRepo *self,
    -                  GCancellable *cancellable,
    -                  GError **error);
    + GCancellable *cancellable, + GError **error);

    ostree_repo_set_disable_fsync ()

    void
     ostree_repo_set_disable_fsync (OstreeRepo *self,
    -                               gboolean disable_fsync);
    + gboolean disable_fsync);

    Disable requests to fsync() to stable storage during commits. This option should only be used by build system tools which are creating disposable virtual machines, or have higher level mechanisms for @@ -1411,7 +1411,7 @@ ensuring data consistency.

    - + @@ -1421,7 +1421,7 @@ ensuring data consistency.


    ostree_repo_get_disable_fsync ()

    -
    gboolean
    +
    gboolean
     ostree_repo_get_disable_fsync (OstreeRepo *self);

    For more information see ostree_repo_set_disable_fsync().

    @@ -1447,7 +1447,7 @@ ostree_repo_get_disable_fsync (

    ostree_repo_is_system ()

    -
    gboolean
    +
    gboolean
     ostree_repo_is_system (OstreeRepo *repo);

    Parameters

    @@ -1466,15 +1466,15 @@ ostree_repo_is_system (

    Returns

    -

    TRUE if this repository is the root-owned system global repository

    +

    TRUE if this repository is the root-owned system global repository


    ostree_repo_is_writable ()

    -
    gboolean
    +
    gboolean
     ostree_repo_is_writable (OstreeRepo *self,
    -                         GError **error);
    + GError **error);

    Returns whether the repository is writable by the current user. If the repository is not writable, the error indicates why.

    @@ -1494,7 +1494,7 @@ If the repository is not writable, the error<
    - + @@ -1502,7 +1502,7 @@ If the repository is not writable, the error<

    Returns

    -

    TRUE if this repository is writable

    +

    TRUE if this repository is writable


    @@ -1512,9 +1512,9 @@ If the repository is not writable, the error< ostree_repo_create_at (int dfd, const char *path, OstreeRepoMode mode, - GVariant *options, - GCancellable *cancellable, - GError **error); + GVariant *options, + GCancellable *cancellable, + GError **error);

    This is a file-descriptor relative version of ostree_repo_create(). Create the underlying structure on disk for the repository, and call ostree_repo_open_at() on the result, preparing it for use.

    @@ -1578,11 +1578,11 @@ the mode or configuration (repo/config) of an exist

    ostree_repo_create ()

    -
    gboolean
    +
    gboolean
     ostree_repo_create (OstreeRepo *self,
                         OstreeRepoMode mode,
    -                    GCancellable *cancellable,
    -                    GError **error);
    + GCancellable *cancellable, + GError **error);

    Create the underlying structure on disk for the repository, and call ostree_repo_open() on the result, preparing it for use.

    Since version 2016.8, this function will succeed on an existing @@ -1630,7 +1630,7 @@ this function on a repository initialized via

    ostree_repo_get_path ()

    -
    GFile *
    +
    GFile *
     ostree_repo_get_path (OstreeRepo *self);

    Note that since the introduction of ostree_repo_open_at(), this function may return a process-specific path in /proc if the repository was created using @@ -1665,7 +1665,7 @@ ostree_repo_get_mode (

    ostree_repo_get_config ()

    -
    GKeyFile *
    +
    GKeyFile *
     ostree_repo_get_config (OstreeRepo *self);

    Returns

    @@ -1706,7 +1706,7 @@ repository (to see whether a ref was written).


    ostree_repo_hash ()

    -
    guint
    +
    guint
     ostree_repo_hash (OstreeRepo *self);

    Calculate a hash value for the given open repository, suitable for use when putting it into a hash table. It is an error to call this on an OstreeRepo @@ -1737,14 +1737,14 @@ the repository is open and the inode of its root directory has been loaded.


    ostree_repo_equal ()

    -
    gboolean
    +
    gboolean
     ostree_repo_equal (OstreeRepo *a,
                        OstreeRepo *b);

    Check whether two opened repositories are the same on disk: if their root directories are the same inode. If a or b are not open yet (due to -ostree_repo_open() not being called on them yet), FALSE will be returned.

    +ostree_repo_open() not being called on them yet), FALSE will be returned.

    Parameters

    disable_fsync

    If TRUE, do not fsync

    If TRUE, do not fsync

     

    error

    a GError

    a GError

     
    @@ -1769,16 +1769,16 @@ directories are the same inode. If a

    Returns

    -

    TRUE if a +

    TRUE if a and b -are the same repository on disk, FALSE otherwise

    +are the same repository on disk, FALSE otherwise

    Since: 2017.12


    ostree_repo_copy_config ()

    -
    GKeyFile *
    +
    GKeyFile *
     ostree_repo_copy_config (OstreeRepo *self);

    Returns

    @@ -1789,24 +1789,24 @@ ostree_repo_copy_config (

    ostree_repo_remote_add ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_add (OstreeRepo *self,
                             const char *name,
                             const char *url,
    -                        GVariant *options,
    -                        GCancellable *cancellable,
    -                        GError **error);
    + GVariant *options, + GCancellable *cancellable, + GError **error);

    Create a new remote named name pointing to url . If options is -provided, then it will be mapped to GKeyFile entries, where the +provided, then it will be mapped to GKeyFile entries, where the GVariant dictionary key is an option string, and the value is mapped as follows:

    Parameters

    @@ -1854,11 +1854,11 @@ mapped as follows:


    ostree_repo_remote_delete ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_delete (OstreeRepo *self,
                                const char *name,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GCancellable *cancellable, + GError **error);

    Delete the remote named name . It is an error if the provided remote does not exist.

    @@ -1898,15 +1898,15 @@ remote does not exist.


    ostree_repo_remote_change ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_change (OstreeRepo *self,
    -                           GFile *sysroot,
    +                           GFile *sysroot,
                                OstreeRepoRemoteChange changeop,
                                const char *name,
                                const char *url,
    -                           GVariant *options,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GVariant *options, + GCancellable *cancellable, + GError **error);

    A combined function handling the equivalent of ostree_repo_remote_add(), ostree_repo_remote_delete(), with more options.

    @@ -1968,9 +1968,9 @@ options.

    ostree_repo_remote_list ()

    char **
     ostree_repo_remote_list (OstreeRepo *self,
    -                         guint *out_n_remotes);
    + guint *out_n_remotes);

    List available remote names in an OstreeRepo. Remote names are sorted -alphabetically. If no remotes are available the function returns NULL.

    +alphabetically. If no remotes are available the function returns NULL.

    Parameters

    @@ -1995,7 +1995,7 @@ alphabetically. If no remotes are available the function returns

    Returns

    -

    a NULL-terminated +

    a NULL-terminated array of remote names.

    [array length=out_n_remotes][transfer full]

    @@ -2003,11 +2003,11 @@ array of remote names.


    ostree_repo_remote_get_url ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_get_url (OstreeRepo *self,
                                 const char *name,
                                 char **out_url,
    -                            GError **error);
    + GError **error);

    Return the URL of the remote named name through out_url . It is an @@ -2046,17 +2046,17 @@ error if the provided remote does not exist.

    Returns

    -

    TRUE on success, FALSE on failure

    +

    TRUE on success, FALSE on failure


    ostree_repo_remote_get_gpg_verify ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_get_gpg_verify (OstreeRepo *self,
                                        const char *name,
    -                                   gboolean *out_gpg_verify,
    -                                   GError **error);
    + gboolean *out_gpg_verify, + GError **error);

    Return whether GPG verification is enabled for the remote named name through out_gpg_verify @@ -2096,18 +2096,18 @@ not exist.

    Returns

    -

    TRUE on success, FALSE on failure

    +

    TRUE on success, FALSE on failure


    ostree_repo_remote_get_gpg_verify_summary ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_get_gpg_verify_summary
                                    (OstreeRepo *self,
                                     const char *name,
    -                                gboolean *out_gpg_verify_summary,
    -                                GError **error);
    + gboolean *out_gpg_verify_summary, + GError **error);

    Return whether GPG verification of the summary is enabled for the remote named name through out_gpg_verify_summary @@ -2147,27 +2147,27 @@ remote does not exist.

    Returns

    -

    TRUE on success, FALSE on failure

    +

    TRUE on success, FALSE on failure


    ostree_repo_remote_gpg_import ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_gpg_import (OstreeRepo *self,
                                    const char *name,
    -                               GInputStream *source_stream,
    +                               GInputStream *source_stream,
                                    const char * const *key_ids,
    -                               guint *out_imported,
    -                               GCancellable *cancellable,
    -                               GError **error);
    + guint *out_imported, + GCancellable *cancellable, + GError **error);

    Imports one or more GPG keys from the open source_stream , or from the user's personal keyring if source_stream - is NULL. The key_ids + is NULL. The key_ids array can optionally restrict which keys are imported. If key_ids - is NULL, + is NULL, then all keys are imported.

    The imported keys will be used to conduct GPG verification when pulling from the remote named name @@ -2193,28 +2193,28 @@ from the remote named name

    - + - + +keys, or NULL.

    - + - + @@ -2222,19 +2222,19 @@ keys, or

    Returns

    -

    TRUE on success, FALSE on failure

    +

    TRUE on success, FALSE on failure


    ostree_repo_remote_fetch_summary ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_fetch_summary (OstreeRepo *self,
                                       const char *name,
    -                                  GBytes **out_summary,
    -                                  GBytes **out_signatures,
    -                                  GCancellable *cancellable,
    -                                  GError **error);
    + GBytes **out_summary, + GBytes **out_signatures, + GCancellable *cancellable, + GError **error);

    Tries to fetch the summary file and any GPG signatures on the summary file over HTTP, and returns the binary data in out_summary and out_signatures @@ -2246,10 +2246,10 @@ respectively.

    . Likewise if the summary file is not signed, out_signatures is set to NULL -. In either case the function still returns TRUE.

    +. In either case the function still returns TRUE.

    This method does not verify the signature of the downloaded summary file. Use ostree_repo_verify_summary() for that.

    -

    Parse the summary data into a GVariant using g_variant_new_from_bytes() +

    Parse the summary data into a GVariant using g_variant_new_from_bytes() with OSTREE_SUMMARY_GVARIANT_FORMAT as the format string.

    Parameters

    @@ -2273,23 +2273,23 @@ with

    out_summary

    +NULL.

    +signature data, or NULL.

    - + - + @@ -2297,21 +2297,21 @@ signature data, or

    Returns

    -

    TRUE on success, FALSE on failure

    +

    TRUE on success, FALSE on failure


    ostree_repo_remote_fetch_summary_with_options ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_fetch_summary_with_options
                                    (OstreeRepo *self,
                                     const char *name,
    -                                GVariant *options,
    -                                GBytes **out_summary,
    -                                GBytes **out_signatures,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GVariant *options, + GBytes **out_summary, + GBytes **out_signatures, + GCancellable *cancellable, + GError **error);

    Like ostree_repo_remote_fetch_summary(), but supports an extensible set of flags. The following are currently defined:

      @@ -2349,23 +2349,23 @@ means return errors without retrying

    +NULL.

    +signature data, or NULL.

    - + - + @@ -2373,16 +2373,16 @@ signature data, or

    Returns

    -

    TRUE on success, FALSE on failure

    +

    TRUE on success, FALSE on failure


    ostree_repo_reload_config ()

    -
    gboolean
    +
    gboolean
     ostree_repo_reload_config (OstreeRepo *self,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GCancellable *cancellable, + GError **error);

    By default, an OstreeRepo will cache the remote configuration and its own repo/config data. This API can be used to reload it.

    @@ -2416,13 +2416,13 @@ own repo/config data. This API can be used to reload it.


    ostree_repo_get_remote_boolean_option ()

    -
    gboolean
    +
    gboolean
     ostree_repo_get_remote_boolean_option (OstreeRepo *self,
                                            const char *remote_name,
                                            const char *option_name,
    -                                       gboolean default_value,
    -                                       gboolean *out_value,
    -                                       GError **error);
    + gboolean default_value, + gboolean *out_value, + GError **error);

    OSTree remotes are represented by keyfile groups, formatted like: [remote "remotename"]. This function returns a value named option_name @@ -2431,7 +2431,7 @@ If the option is not set, out_value will be set to default_value . If an error is returned, out_value - will be set to FALSE.

    + will be set to FALSE.

    Parameters

    source_stream

    a GInputStream, or NULL.

    a GInputStream, or NULL.

    [allow-none]

    key_ids

    a NULL-terminated array of GPG key IDs, or NULL.

    a NULL-terminated array of GPG key IDs, or NULL.

    [array zero-terminated=1][element-type utf8][allow-none]

    out_imported

    return location for the number of imported -keys, or NULL.

    [allow-none]

    cancellable

    a GCancellable

    a GCancellable

     

    error

    a GError

    a GError

     

    return location for raw summary data, or -NULL.

    [out][optional]

    out_signatures

    return location for raw summary -signature data, or NULL.

    [out][optional]

    cancellable

    a GCancellable

    a GCancellable

     

    error

    a GError

    a GError

     

    out_summary

    return location for raw summary data, or -NULL.

    [out][optional]

    out_signatures

    return location for raw summary -signature data, or NULL.

    [out][optional]

    cancellable

    a GCancellable

    a GCancellable

     

    error

    a GError

    a GError

     
    @@ -2477,26 +2477,26 @@ is not present

    Returns

    -

    TRUE on success, otherwise FALSE with error +

    TRUE on success, otherwise FALSE with error set


    ostree_repo_get_remote_list_option ()

    -
    gboolean
    +
    gboolean
     ostree_repo_get_remote_list_option (OstreeRepo *self,
                                         const char *remote_name,
                                         const char *option_name,
                                         char ***out_value,
    -                                    GError **error);
    + GError **error);

    OSTree remotes are represented by keyfile groups, formatted like: [remote "remotename"]. This function returns a value named option_name underneath that group, and returns it as a zero terminated array of strings. If the option is not set, or if an error is returned, out_value will be set -to NULL.

    +to NULL.

    Parameters

    @@ -2525,7 +2525,7 @@ to

    out_value

    +g_strfreev().

    @@ -2538,27 +2538,27 @@ of strings. The list should be freed with

    Returns

    -

    TRUE on success, otherwise FALSE with error +

    TRUE on success, otherwise FALSE with error set


    ostree_repo_get_remote_option ()

    -
    gboolean
    +
    gboolean
     ostree_repo_get_remote_option (OstreeRepo *self,
                                    const char *remote_name,
                                    const char *option_name,
                                    const char *default_value,
                                    char **out_value,
    -                               GError **error);
    + GError **error);

    OSTree remotes are represented by keyfile groups, formatted like: [remote "remotename"]. This function returns a value named option_name underneath that group, or default_value if the remote exists but not the option name. If an error is returned, out_value - will be set to NULL.

    + will be set to NULL.

    Parameters

    location to store the list of strings. The list should be freed with -g_strfreev().

    [out][array zero-terminated=1]
    @@ -2604,7 +2604,7 @@ is not present.

    Returns

    -

    TRUE on success, otherwise FALSE with error +

    TRUE on success, otherwise FALSE with error set

    @@ -2632,17 +2632,17 @@ called.

    Returns

    -

    Parent repository, or NULL if none.

    +

    Parent repository, or NULL if none.

    [transfer none]


    ostree_repo_write_config ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_config (OstreeRepo *self,
    -                          GKeyFile *new_config,
    -                          GError **error);
    + GKeyFile *new_config, + GError **error);

    Save new_config in place of this repository's config file. Note that new_config @@ -2669,7 +2669,7 @@ simply adds a reference.

    - + @@ -2679,10 +2679,10 @@ simply adds a reference.


    ostree_repo_scan_hardlinks ()

    -
    gboolean
    +
    gboolean
     ostree_repo_scan_hardlinks (OstreeRepo *self,
    -                            GCancellable *cancellable,
    -                            GError **error);
    + GCancellable *cancellable, + GError **error);

    This function is deprecated in favor of using ostree_repo_devino_cache_new(), which allows a precise mapping to be built up between hardlink checkout files and their checksums between ostree_repo_checkout_at() and @@ -2728,11 +2728,11 @@ before you call

    ostree_repo_prepare_transaction ()

    -
    gboolean
    +
    gboolean
     ostree_repo_prepare_transaction (OstreeRepo *self,
    -                                 gboolean *out_transaction_resume,
    -                                 GCancellable *cancellable,
    -                                 GError **error);
    + gboolean *out_transaction_resume, + GCancellable *cancellable, + GError **error);

    Starts or resumes a transaction. In order to write to a repo, you need to start a transaction. You can complete the transaction with ostree_repo_commit_transaction(), or abort the transaction with @@ -2785,11 +2785,11 @@ pulls use per-commit state/.commitpartial files.

    ostree_repo_commit_transaction ()

    -
    gboolean
    +
    gboolean
     ostree_repo_commit_transaction (OstreeRepo *self,
                                     OstreeRepoTransactionStats *out_stats,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GCancellable *cancellable, + GError **error);

    Complete the transaction. Any refs set with ostree_repo_transaction_set_ref() or ostree_repo_transaction_set_refspec() will be written out.

    @@ -2835,10 +2835,10 @@ that happened during this transaction.


    ostree_repo_abort_transaction ()

    -
    gboolean
    +
    gboolean
     ostree_repo_abort_transaction (OstreeRepo *self,
    -                               GCancellable *cancellable,
    -                               GError **error);
    + GCancellable *cancellable, + GError **error);

    Abort the active transaction; any staged objects and ref changes will be discarded. You *must* invoke this if you have chosen not to invoke ostree_repo_commit_transaction(). Calling this function when not in a @@ -2920,13 +2920,13 @@ ostree_repo_transaction_set_ref (const char *ref, const char *checksum);

    If checksum - is not NULL, then record it as the target of ref named + is not NULL, then record it as the target of ref named ref ; if remote is provided, the ref will appear to originate from that remote.

    Otherwise, if checksum - is NULL, then record that the ref should + is NULL, then record that the ref should be deleted.

    The change will be written when the transaction is completed with ostree_repo_commit_transaction(); that function takes care of writing all of @@ -2977,13 +2977,13 @@ case.


    ostree_repo_set_ref_immediate ()

    -
    gboolean
    +
    gboolean
     ostree_repo_set_ref_immediate (OstreeRepo *self,
                                    const char *remote,
                                    const char *ref,
                                    const char *checksum,
    -                               GCancellable *cancellable,
    -                               GError **error);
    + GCancellable *cancellable, + GError **error);

    This is like ostree_repo_transaction_set_ref(), except it may be invoked outside of a transaction. This is presently safe for the case where we're creating or overwriting an existing ref.

    @@ -3014,7 +3014,7 @@ case where we're creating or overwriting an existing ref.

    - + @@ -3034,13 +3034,13 @@ case where we're creating or overwriting an existing ref.


    ostree_repo_set_alias_ref_immediate ()

    -
    gboolean
    +
    gboolean
     ostree_repo_set_alias_ref_immediate (OstreeRepo *self,
                                          const char *remote,
                                          const char *ref,
                                          const char *target,
    -                                     GCancellable *cancellable,
    -                                     GError **error);
    + GCancellable *cancellable, + GError **error);

    Like ostree_repo_set_ref_immediate(), but creates an alias.

    Parameters

    @@ -3068,7 +3068,7 @@ ostree_repo_set_alias_ref_immediate (
    - + @@ -3088,12 +3088,12 @@ ostree_repo_set_alias_ref_immediate (

    ostree_repo_set_cache_dir ()

    -
    gboolean
    +
    gboolean
     ostree_repo_set_cache_dir (OstreeRepo *self,
                                int dfd,
                                const char *path,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GCancellable *cancellable, + GError **error);

    Set a custom location for the cache directory used for e.g. per-remote summary caches. Setting this manually is useful when doing operations on a system repo as a user because you don't have @@ -3125,12 +3125,12 @@ write permissions in the repo, where the cache is normally stored.

    - + - + @@ -3140,14 +3140,14 @@ write permissions in the repo, where the cache is normally stored.


    ostree_repo_sign_delta ()

    -
    gboolean
    +
    gboolean
     ostree_repo_sign_delta (OstreeRepo *self,
    -                        const gchar *from_commit,
    -                        const gchar *to_commit,
    -                        const gchar *key_id,
    -                        const gchar *homedir,
    -                        GCancellable *cancellable,
    -                        GError **error);
    + const gchar *from_commit, + const gchar *to_commit, + const gchar *key_id, + const gchar *homedir, + GCancellable *cancellable, + GError **error);

    This function is deprecated, sign the summary file instead. Add a GPG signature to a static delta.

    @@ -3201,17 +3201,17 @@ Add a GPG signature to a static delta.


    ostree_repo_has_object ()

    -
    gboolean
    +
    gboolean
     ostree_repo_has_object (OstreeRepo *self,
                             OstreeObjectType objtype,
                             const char *checksum,
    -                        gboolean *out_have_object,
    -                        GCancellable *cancellable,
    -                        GError **error);
    + gboolean *out_have_object, + GCancellable *cancellable, + GError **error);

    Set out_have_object - to TRUE if self + to TRUE if self contains the given object; -FALSE otherwise.

    +FALSE otherwise.

    Parameters

    error

    a GError

    a GError

     

    checksum

    The checksum to point it to, or NULL to unset.

    The checksum to point it to, or NULL to unset.

    [allow-none]

    target

    The ref target to point it to, or NULL to unset.

    The ref target to point it to, or NULL to unset.

    [allow-none]

    cancellable

    a GCancellable

    a GCancellable

     

    error

    a GError

    a GError

     
    @@ -3238,7 +3238,7 @@ ostree_repo_has_object (

    out_have_object

    -
    + @@ -3256,17 +3256,17 @@ ostree_repo_has_object (

    Returns

    -

    FALSE if an unexpected error occurred, TRUE otherwise

    +

    FALSE if an unexpected error occurred, TRUE otherwise


    ostree_repo_mark_commit_partial ()

    -
    gboolean
    +
    gboolean
     ostree_repo_mark_commit_partial (OstreeRepo *self,
                                      const char *checksum,
    -                                 gboolean is_partial,
    -                                 GError **error);
    + gboolean is_partial, + GError **error);

    Commits in "partial" state do not have all their child objects written. This occurs in various situations, such as during a pull, but also if a "subpath" pull is used, as well as "commit only" pulls.

    @@ -3309,20 +3309,20 @@ should use this if you are implementing a different type of transport.


    ostree_repo_write_metadata ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_metadata (OstreeRepo *self,
                                 OstreeObjectType objtype,
                                 const char *expected_checksum,
    -                            GVariant *object,
    -                            guchar **out_csum,
    -                            GCancellable *cancellable,
    -                            GError **error);
    + GVariant *object, + guchar **out_csum, + GCancellable *cancellable, + GError **error);

    Store the metadata object object . Return the checksum as out_csum .

    If expected_checksum - is not NULL, verify it against the + is not NULL, verify it against the computed checksum.

    Parameters

    @@ -3379,10 +3379,10 @@ computed checksum.

    ostree_repo_write_metadata_async (OstreeRepo *self, OstreeObjectType objtype, const char *expected_checksum, - GVariant *object, - GCancellable *cancellable, - GAsyncReadyCallback callback, - gpointer user_data); + GVariant *object, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

    Asynchronously store the metadata object variant . If provided, the checksum expected_checksum @@ -3439,11 +3439,11 @@ the checksum expected_checksum


    ostree_repo_write_metadata_finish ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_metadata_finish (OstreeRepo *self,
    -                                   GAsyncResult *result,
    -                                   guchar **out_csum,
    -                                   GError **error);
    + GAsyncResult *result, + guchar **out_csum, + GError **error);

    Complete a call to ostree_repo_write_metadata_async().

    Parameters

    @@ -3481,14 +3481,14 @@ ostree_repo_write_metadata_finish (

    ostree_repo_write_content ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_content (OstreeRepo *self,
                                const char *expected_checksum,
    -                           GInputStream *object_input,
    -                           guint64 length,
    -                           guchar **out_csum,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GInputStream *object_input, + guint64 length, + guchar **out_csum, + GCancellable *cancellable, + GError **error);

    Store the content object streamed as object_input , with total length length @@ -3547,13 +3547,13 @@ be returned as out_csum


    ostree_repo_write_metadata_trusted ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_metadata_trusted (OstreeRepo *self,
                                         OstreeObjectType objtype,
                                         const char *checksum,
    -                                    GVariant *variant,
    -                                    GCancellable *cancellable,
    -                                    GError **error);
    + GVariant *variant, + GCancellable *cancellable, + GError **error);

    Store the metadata object variant ; the provided checksum is @@ -3604,15 +3604,15 @@ trusted.


    ostree_repo_write_metadata_stream_trusted ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_metadata_stream_trusted
                                    (OstreeRepo *self,
                                     OstreeObjectType objtype,
                                     const char *checksum,
    -                                GInputStream *object_input,
    -                                guint64 length,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GInputStream *object_input, + guint64 length, + GCancellable *cancellable, + GError **error);

    Store the metadata object variant ; the provided checksum is @@ -3668,13 +3668,13 @@ trusted.


    ostree_repo_write_content_trusted ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_content_trusted (OstreeRepo *self,
                                        const char *checksum,
    -                                   GInputStream *object_input,
    -                                   guint64 length,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + GInputStream *object_input, + guint64 length, + GCancellable *cancellable, + GError **error);

    Store the content object streamed as object_input , with total length length @@ -3733,11 +3733,11 @@ disk, for example.

    void
     ostree_repo_write_content_async (OstreeRepo *self,
                                      const char *expected_checksum,
    -                                 GInputStream *object,
    -                                 guint64 length,
    -                                 GCancellable *cancellable,
    -                                 GAsyncReadyCallback callback,
    -                                 gpointer user_data);
    + GInputStream *object, + guint64 length, + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

    Asynchronously store the content object object . If provided, the checksum expected_checksum @@ -3795,11 +3795,11 @@ checksum expected_checksum


    ostree_repo_write_content_finish ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_content_finish (OstreeRepo *self,
    -                                  GAsyncResult *result,
    -                                  guchar **out_csum,
    -                                  GError **error);
    + GAsyncResult *result, + guchar **out_csum, + GError **error);

    Completes an invocation of ostree_repo_write_content_async().

    Parameters

    @@ -3817,7 +3817,7 @@ ostree_repo_write_content_finish (
    - + @@ -3827,7 +3827,7 @@ ostree_repo_write_content_finish ( - + @@ -3837,12 +3837,12 @@ ostree_repo_write_content_finish (

    ostree_repo_resolve_rev ()

    -
    gboolean
    +
    gboolean
     ostree_repo_resolve_rev (OstreeRepo *self,
                              const char *refspec,
    -                         gboolean allow_noent,
    +                         gboolean allow_noent,
                              char **out_rev,
    -                         GError **error);
    + GError **error);

    Look up the given refspec, returning the checksum it references in the parameter out_rev . Will fall back on remote directory if cannot @@ -3873,7 +3873,7 @@ find the given refspec in local.

    - @@ -3889,13 +3889,13 @@ is true and it does not exist.


    ostree_repo_resolve_rev_ext ()

    -
    gboolean
    +
    gboolean
     ostree_repo_resolve_rev_ext (OstreeRepo *self,
                                  const char *refspec,
    -                             gboolean allow_noent,
    +                             gboolean allow_noent,
                                  OstreeRepoResolveRevExtFlags flags,
                                  char **out_rev,
    -                             GError **error);
    + GError **error);

    Look up the given refspec, returning the checksum it references in the parameter out_rev . Differently from ostree_repo_resolve_rev(), @@ -3932,7 +3932,7 @@ local ref is specified but not found.

    - @@ -3948,14 +3948,14 @@ is true and it does not exist.


    ostree_repo_list_refs ()

    -
    gboolean
    +
    gboolean
     ostree_repo_list_refs (OstreeRepo *self,
                            const char *refspec_prefix,
    -                       GHashTable **out_all_refs,
    -                       GCancellable *cancellable,
    -                       GError **error);
    + GHashTable **out_all_refs, + GCancellable *cancellable, + GError **error);

    If refspec_prefix - is NULL, list all local and remote refspecs, + is NULL, list all local and remote refspecs, with their current values in out_all_refs . Otherwise, only list refspecs which have refspec_prefix @@ -3963,7 +3963,7 @@ refspecs which have refspec_prefix

    out_all_refs will be returned as a mapping from refspecs (including the remote name) to checksums. If refspec_prefix - is non-NULL, it will be + is non-NULL, it will be removed as a prefix from the hash table keys.

    Parameters

    @@ -4006,15 +4006,15 @@ removed as a prefix from the hash table keys.


    ostree_repo_list_refs_ext ()

    -
    gboolean
    +
    gboolean
     ostree_repo_list_refs_ext (OstreeRepo *self,
                                const char *refspec_prefix,
    -                           GHashTable **out_all_refs,
    +                           GHashTable **out_all_refs,
                                OstreeRepoListRefsExtFlags flags,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GCancellable *cancellable, + GError **error);

    If refspec_prefix - is NULL, list all local and remote refspecs, + is NULL, list all local and remote refspecs, with their current values in out_all_refs . Otherwise, only list refspecs which have refspec_prefix @@ -4070,12 +4070,12 @@ remote name) to checksums. Differently from

    ostree_repo_remote_list_refs ()

    -
    gboolean
    +
    gboolean
     ostree_repo_remote_list_refs (OstreeRepo *self,
                                   const char *remote_name,
    -                              GHashTable **out_all_refs,
    -                              GCancellable *cancellable,
    -                              GError **error);
    + GHashTable **out_all_refs, + GCancellable *cancellable, + GError **error);

    Parameters

    TRUE if repository contains object.

    TRUE if repository contains object.

    [out]

    result

    a GAsyncResult

    a GAsyncResult

     

    error

    a GError

    a GError

     

    out_rev

    A checksum,or NULL if allow_noent +

    A checksum,or NULL if allow_noent is true and it does not exist.

    [out][transfer full]

    out_rev

    A checksum,or NULL if allow_noent +

    A checksum,or NULL if allow_noent is true and it does not exist.

    [out][transfer full]
    @@ -4117,12 +4117,12 @@ ostree_repo_remote_list_refs (

    ostree_repo_load_variant ()

    -
    gboolean
    +
    gboolean
     ostree_repo_load_variant (OstreeRepo *self,
                               OstreeObjectType objtype,
                               const char *sha256,
    -                          GVariant **out_variant,
    -                          GError **error);
    + GVariant **out_variant, + GError **error);

    Load the metadata object sha256 of type objtype , storing the @@ -4169,12 +4169,12 @@ result in out_variant


    ostree_repo_load_commit ()

    -
    gboolean
    +
    gboolean
     ostree_repo_load_commit (OstreeRepo *self,
                              const char *checksum,
    -                         GVariant **out_commit,
    +                         GVariant **out_commit,
                              OstreeRepoCommitState *out_state,
    -                         GError **error);
    + GError **error);

    A version of ostree_repo_load_variant() specialized to commits, capable of returning extended state information. Currently the only extended state is OSTREE_REPO_COMMIT_STATE_PARTIAL, which @@ -4220,18 +4220,18 @@ means that only a sub-path of the commit is available.


    ostree_repo_load_variant_if_exists ()

    -
    gboolean
    +
    gboolean
     ostree_repo_load_variant_if_exists (OstreeRepo *self,
                                         OstreeObjectType objtype,
                                         const char *sha256,
    -                                    GVariant **out_variant,
    -                                    GError **error);
    + GVariant **out_variant, + GError **error);

    Attempt to load the metadata object sha256 of type objtype if it exists, storing the result in out_variant . If it doesn't exist, -NULL is returned.

    +NULL is returned.

    Parameters

    @@ -4273,14 +4273,14 @@ exists, storing the result in out_variant

    ostree_repo_load_file ()

    -
    gboolean
    +
    gboolean
     ostree_repo_load_file (OstreeRepo *self,
                            const char *checksum,
    -                       GInputStream **out_input,
    -                       GFileInfo **out_file_info,
    -                       GVariant **out_xattrs,
    -                       GCancellable *cancellable,
    -                       GError **error);
    + GInputStream **out_input, + GFileInfo **out_file_info, + GVariant **out_xattrs, + GCancellable *cancellable, + GError **error);

    Load content object, decomposing it into three parts: the actual content (for regular files), the metadata, and extended attributes.

    @@ -4334,14 +4334,14 @@ content (for regular files), the metadata, and extended attributes.


    ostree_repo_load_object_stream ()

    -
    gboolean
    +
    gboolean
     ostree_repo_load_object_stream (OstreeRepo *self,
                                     OstreeObjectType objtype,
                                     const char *checksum,
    -                                GInputStream **out_input,
    -                                guint64 *out_size,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GInputStream **out_input, + guint64 *out_size, + GCancellable *cancellable, + GError **error);

    Load object as a stream; useful when copying objects between repositories.

    @@ -4396,13 +4396,13 @@ repositories.


    ostree_repo_query_object_storage_size ()

    -
    gboolean
    +
    gboolean
     ostree_repo_query_object_storage_size (OstreeRepo *self,
                                            OstreeObjectType objtype,
                                            const char *sha256,
    -                                       guint64 *out_size,
    -                                       GCancellable *cancellable,
    -                                       GError **error);
    + guint64 *out_size, + GCancellable *cancellable, + GError **error);

    Return the size in bytes of object with checksum sha256 , after any compression has been applied.

    @@ -4452,13 +4452,13 @@ compression has been applied.


    ostree_repo_import_object_from ()

    -
    gboolean
    +
    gboolean
     ostree_repo_import_object_from (OstreeRepo *self,
                                     OstreeRepo *source,
                                     OstreeObjectType objtype,
                                     const char *checksum,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GCancellable *cancellable, + GError **error);

    Copy object named by objtype and checksum into self @@ -4514,15 +4514,15 @@ hard link operation.


    ostree_repo_import_object_from_with_trust ()

    -
    gboolean
    +
    gboolean
     ostree_repo_import_object_from_with_trust
                                    (OstreeRepo *self,
                                     OstreeRepo *source,
                                     OstreeObjectType objtype,
                                     const char *checksum,
    -                                gboolean trusted,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + gboolean trusted, + GCancellable *cancellable, + GError **error);

    Copy object named by objtype and checksum into self @@ -4563,7 +4563,7 @@ hard link operation.

    - + @@ -4583,14 +4583,14 @@ hard link operation.


    ostree_repo_import_archive_to_mtree ()

    -
    gboolean
    +
    gboolean
     ostree_repo_import_archive_to_mtree (OstreeRepo *self,
                                          OstreeRepoImportArchiveOptions *opts,
                                          void *archive,
                                          OstreeMutableTree *mtree,
                                          OstreeRepoCommitModifier *modifier,
    -                                     GCancellable *cancellable,
    -                                     GError **error);
    + GCancellable *cancellable, + GError **error);

    Import an archive file archive into the repository, and write its file structure to mtree @@ -4647,13 +4647,13 @@ file structure to mtree


    ostree_repo_export_tree_to_archive ()

    -
    gboolean
    +
    gboolean
     ostree_repo_export_tree_to_archive (OstreeRepo *self,
                                         OstreeRepoExportArchiveOptions *opts,
                                         OstreeRepoFile *root,
                                         void *archive,
    -                                    GCancellable *cancellable,
    -                                    GError **error);
    + GCancellable *cancellable, + GError **error);

    Import an archive file archive into the repository, and write its file structure to mtree @@ -4705,16 +4705,16 @@ file structure to mtree


    ostree_repo_delete_object ()

    -
    gboolean
    +
    gboolean
     ostree_repo_delete_object (OstreeRepo *self,
                                OstreeObjectType objtype,
                                const char *sha256,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GCancellable *cancellable, + GError **error);

    Remove the object of type objtype with checksum sha256 -from the repository. An error of type G_IO_ERROR_NOT_FOUND +from the repository. An error of type G_IO_ERROR_NOT_FOUND is thrown if the object does not exist.

    Parameters

    @@ -4757,12 +4757,12 @@ is thrown if the object does not exist.


    ostree_repo_fsck_object ()

    -
    gboolean
    +
    gboolean
     ostree_repo_fsck_object (OstreeRepo *self,
                              OstreeObjectType objtype,
                              const char *sha256,
    -                         GCancellable *cancellable,
    -                         GError **error);
    + GCancellable *cancellable, + GError **error);

    Verify consistency of the object; this performs checks only relevant to the immediate object itself, such as checksumming. This API call will not itself traverse metadata objects for example.

    @@ -4811,8 +4811,8 @@ traverse metadata objects for example.

    OstreeRepoCommitFilterResult
     (*OstreeRepoCommitFilter) (OstreeRepo *repo,
                                const char *path,
    -                           GFileInfo *file_info,
    -                           gpointer user_data);
    + GFileInfo *file_info, + gpointer user_data);

    Parameters

    trusted

    If TRUE, assume the source repo is valid and trusted

    If TRUE, assume the source repo is valid and trusted

     
    @@ -4856,8 +4856,8 @@ traverse metadata objects for example.

    OstreeRepoCommitModifier *
     ostree_repo_commit_modifier_new (OstreeRepoCommitModifierFlags flags,
                                      OstreeRepoCommitFilter commit_filter,
    -                                 gpointer user_data,
    -                                 GDestroyNotify destroy_notify);
    + gpointer user_data, + GDestroyNotify destroy_notify);

    Parameters

    @@ -4884,7 +4884,7 @@ ostree_repo_commit_modifier_new ( - + @@ -4899,12 +4899,12 @@ ostree_repo_commit_modifier_new (

    OstreeRepoCommitModifierXattrCallback ()

    -
    GVariant *
    +
    GVariant *
     (*OstreeRepoCommitModifierXattrCallback)
                                    (OstreeRepo *repo,
                                     const char *path,
    -                                GFileInfo *file_info,
    -                                gpointer user_data);
    + GFileInfo *file_info, + gpointer user_data);

    @@ -4913,8 +4913,8 @@ ostree_repo_commit_modifier_new (OstreeRepoCommitModifier *modifier, OstreeRepoCommitModifierXattrCallback callback, - GDestroyNotify destroy, - gpointer user_data); + GDestroyNotify destroy, + gpointer user_data);

    If set, this function should return extended attributes to use for the given path. This is useful for things like ACLs and SELinux, where a build system can label the files as it's committing to the @@ -4961,7 +4961,7 @@ ostree_repo_commit_modifier_set_sepolicy (OstreeRepoCommitModifier *modifier, OstreeSePolicy *sepolicy);

    If policy - is non-NULL, use it to look up labels to use for + is non-NULL, use it to look up labels to use for "security.selinux" extended attributes.

    Note that any policy specified this way operates in addition to any extended attributes provided via @@ -5076,19 +5076,19 @@ ostree_repo_devino_cache_unref (O


    ostree_repo_devino_cache_get_type ()

    -
    GType
    +
    GType
     ostree_repo_devino_cache_get_type (void);

    ostree_repo_write_directory_to_mtree ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_directory_to_mtree (OstreeRepo *self,
    -                                      GFile *dir,
    +                                      GFile *dir,
                                           OstreeMutableTree *mtree,
                                           OstreeRepoCommitModifier *modifier,
    -                                      GCancellable *cancellable,
    -                                      GError **error);
    + GCancellable *cancellable, + GError **error);

    Store objects for dir and all children into the repository self , @@ -5140,14 +5140,14 @@ overlaying the resulting filesystem hierarchy into m


    ostree_repo_write_dfd_to_mtree ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_dfd_to_mtree (OstreeRepo *self,
                                     int dfd,
                                     const char *path,
                                     OstreeMutableTree *mtree,
                                     OstreeRepoCommitModifier *modifier,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GCancellable *cancellable, + GError **error);

    Store as objects all contents of the directory referred to by dfd and path @@ -5206,14 +5206,14 @@ resulting filesystem hierarchy into mtree

    ostree_repo_write_archive_to_mtree ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_archive_to_mtree (OstreeRepo *self,
    -                                    GFile *archive,
    +                                    GFile *archive,
                                         OstreeMutableTree *mtree,
                                         OstreeRepoCommitModifier *modifier,
    -                                    gboolean autocreate_parents,
    -                                    GCancellable *cancellable,
    -                                    GError **error);
    + gboolean autocreate_parents, + GCancellable *cancellable, + GError **error);

    Import an archive file archive into the repository, and write its file structure to mtree @@ -5269,12 +5269,12 @@ file structure to mtree


    ostree_repo_write_mtree ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_mtree (OstreeRepo *self,
                              OstreeMutableTree *mtree,
    -                         GFile **out_file,
    -                         GCancellable *cancellable,
    -                         GError **error);
    + GFile **out_file, + GCancellable *cancellable, + GError **error);

    Write all metadata objects for mtree to repo; the resulting out_file @@ -5323,16 +5323,16 @@ the mtree


    ostree_repo_write_commit ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_commit (OstreeRepo *self,
                               const char *parent,
                               const char *subject,
                               const char *body,
    -                          GVariant *metadata,
    +                          GVariant *metadata,
                               OstreeRepoFile *root,
                               char **out_commit,
    -                          GCancellable *cancellable,
    -                          GError **error);
    + GCancellable *cancellable, + GError **error);

    Write a commit metadata object, referencing root_contents_checksum and root_metadata_checksum @@ -5353,7 +5353,7 @@ and root_metadata_checksum

    - + @@ -5368,7 +5368,7 @@ and root_metadata_checksum - + @@ -5398,17 +5398,17 @@ and root_metadata_checksum

    ostree_repo_write_commit_with_time ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_commit_with_time (OstreeRepo *self,
                                         const char *parent,
                                         const char *subject,
                                         const char *body,
    -                                    GVariant *metadata,
    +                                    GVariant *metadata,
                                         OstreeRepoFile *root,
    -                                    guint64 time,
    +                                    guint64 time,
                                         char **out_commit,
    -                                    GCancellable *cancellable,
    -                                    GError **error);
    + GCancellable *cancellable, + GError **error);

    Write a commit metadata object, referencing root_contents_checksum and root_metadata_checksum @@ -5429,7 +5429,7 @@ and root_metadata_checksum

    - + @@ -5444,7 +5444,7 @@ and root_metadata_checksum - + @@ -5479,17 +5479,17 @@ and root_metadata_checksum

    ostree_repo_read_commit_detached_metadata ()

    -
    gboolean
    +
    gboolean
     ostree_repo_read_commit_detached_metadata
                                    (OstreeRepo *self,
                                     const char *checksum,
    -                                GVariant **out_metadata,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GVariant **out_metadata, + GCancellable *cancellable, + GError **error);

    OSTree commits can have arbitrary metadata associated; this function retrieves them. If none exists, out_metadata will be set -to NULL.

    +to NULL.

    Parameters

    destroy_notify

    A GDestroyNotify

    A GDestroyNotify

     

    parent

    ASCII SHA256 checksum for parent, or NULL for none.

    ASCII SHA256 checksum for parent, or NULL for none.

    [allow-none]

    metadata

    GVariant of type a{sv}, or NULL for none.

    GVariant of type a{sv}, or NULL for none.

    [allow-none]

    parent

    ASCII SHA256 checksum for parent, or NULL for none.

    ASCII SHA256 checksum for parent, or NULL for none.

    [allow-none]

    metadata

    GVariant of type a{sv}, or NULL for none.

    GVariant of type a{sv}, or NULL for none.

    [allow-none]
    @@ -5511,7 +5511,7 @@ to - + @@ -5531,18 +5531,18 @@ to

    ostree_repo_write_commit_detached_metadata ()

    -
    gboolean
    +
    gboolean
     ostree_repo_write_commit_detached_metadata
                                    (OstreeRepo *self,
                                     const char *checksum,
    -                                GVariant *metadata,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GVariant *metadata, + GCancellable *cancellable, + GError **error);

    Replace any existing metadata associated with commit referred to by checksum with metadata . If metadata - is NULL, then existing + is NULL, then existing data will be deleted.

    Parameters

    @@ -5565,7 +5565,7 @@ data will be deleted.

    - + @@ -5623,15 +5623,15 @@ ostree_repo_checkout_at_options_set_devino

    ostree_repo_checkout_tree ()

    -
    gboolean
    +
    gboolean
     ostree_repo_checkout_tree (OstreeRepo *self,
                                OstreeRepoCheckoutMode mode,
                                OstreeRepoCheckoutOverwriteMode overwrite_mode,
    -                           GFile *destination,
    +                           GFile *destination,
                                OstreeRepoFile *source,
    -                           GFileInfo *source_info,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GFileInfo *source_info, + GCancellable *cancellable, + GError **error);

    Check out source into destination , which must live on the @@ -5697,14 +5697,14 @@ files are checked out.


    ostree_repo_checkout_tree_at ()

    -
    gboolean
    +
    gboolean
     ostree_repo_checkout_tree_at (OstreeRepo *self,
                                   OstreeRepoCheckoutOptions *options,
                                   int destination_dfd,
                                   const char *destination_path,
                                   const char *commit,
    -                              GCancellable *cancellable,
    -                              GError **error);
    + GCancellable *cancellable, + GError **error);

    ostree_repo_checkout_tree_at is deprecated and should not be used in newly-written code.

    Similar to ostree_repo_checkout_tree(), but uses directory-relative paths for the destination, uses a new OstreeRepoCheckoutAtOptions, @@ -5766,14 +5766,14 @@ cache.


    ostree_repo_checkout_at ()

    -
    gboolean
    +
    gboolean
     ostree_repo_checkout_at (OstreeRepo *self,
                              OstreeRepoCheckoutAtOptions *options,
                              int destination_dfd,
                              const char *destination_path,
                              const char *commit,
    -                         GCancellable *cancellable,
    -                         GError **error);
    + GCancellable *cancellable, + GError **error);

    Similar to ostree_repo_checkout_tree(), but uses directory-relative paths for the destination, uses a new OstreeRepoCheckoutAtOptions, and takes a commit checksum and optional subpath pair, rather than @@ -5834,10 +5834,10 @@ cache.


    ostree_repo_checkout_gc ()

    -
    gboolean
    +
    gboolean
     ostree_repo_checkout_gc (OstreeRepo *self,
    -                         GCancellable *cancellable,
    -                         GError **error);
    + GCancellable *cancellable, + GError **error);

    Call this after finishing a succession of checkout operations; it will delete any currently-unused uncompressed objects from the cache.

    @@ -5872,13 +5872,13 @@ cache.


    ostree_repo_read_commit ()

    -
    gboolean
    +
    gboolean
     ostree_repo_read_commit (OstreeRepo *self,
                              const char *ref,
    -                         GFile **out_root,
    +                         GFile **out_root,
                              char **out_commit,
    -                         GCancellable *cancellable,
    -                         GError **error);
    + GCancellable *cancellable, + GError **error);

    Load the content for rev into out_root .

    @@ -5928,18 +5928,18 @@ ostree_repo_read_commit (

    ostree_repo_list_objects ()

    -
    gboolean
    +
    gboolean
     ostree_repo_list_objects (OstreeRepo *self,
                               OstreeRepoListObjectsFlags flags,
    -                          GHashTable **out_objects,
    -                          GCancellable *cancellable,
    -                          GError **error);
    + GHashTable **out_objects, + GCancellable *cancellable, + GError **error);

    This function synchronously enumerates all objects in the repository, returning data in out_objects . out_objects maps from keys returned by ostree_object_name_serialize() -to GVariant values of type OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE.

    +to GVariant values of type OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE.

    Parameters

    out_metadata

    Metadata associated with commit in with format "a{sv}", or NULL if none exists.

    Metadata associated with commit in with format "a{sv}", or NULL if none exists.

    [out][transfer full]

    metadata

    Metadata to associate with commit in with format "a{sv}", or NULL to delete.

    Metadata to associate with commit in with format "a{sv}", or NULL to delete.

    [allow-none]
    @@ -5979,20 +5979,20 @@ to

    Returns

    -

    TRUE on success, FALSE on error, and error +

    TRUE on success, FALSE on error, and error will be set


    ostree_repo_list_commit_objects_starting_with ()

    -
    gboolean
    +
    gboolean
     ostree_repo_list_commit_objects_starting_with
                                    (OstreeRepo *self,
                                     const char *start,
    -                                GHashTable **out_commits,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GHashTable **out_commits, + GCancellable *cancellable, + GError **error);

    This function synchronously enumerates all commit objects starting with start , returning data in out_commits @@ -6036,18 +6036,18 @@ with start

    Returns

    -

    TRUE on success, FALSE on error, and error +

    TRUE on success, FALSE on error, and error will be set


    ostree_repo_list_static_delta_names ()

    -
    gboolean
    +
    gboolean
     ostree_repo_list_static_delta_names (OstreeRepo *self,
    -                                     GPtrArray **out_deltas,
    -                                     GCancellable *cancellable,
    -                                     GError **error);
    + GPtrArray **out_deltas, + GCancellable *cancellable, + GError **error);

    This function synchronously enumerates all static deltas in the repository, returning its result in out_deltas .

    @@ -6087,17 +6087,17 @@ repository, returning its result in out_deltas

    ostree_repo_static_delta_generate ()

    -
    gboolean
    +
    gboolean
     ostree_repo_static_delta_generate (OstreeRepo *self,
                                        OstreeStaticDeltaGenerateOpt opt,
                                        const char *from,
                                        const char *to,
    -                                   GVariant *metadata,
    -                                   GVariant *params,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + GVariant *metadata, + GVariant *params, + GCancellable *cancellable, + GError **error);

    Generate a lookaside "static delta" from from - (NULL means + (NULL means from-empty) which can generate the objects in to . This delta is an optimization over fetching individual objects, and can be @@ -6138,7 +6138,7 @@ for input files

    - + @@ -6173,13 +6173,13 @@ for input files


    ostree_repo_static_delta_execute_offline ()

    -
    gboolean
    +
    gboolean
     ostree_repo_static_delta_execute_offline
                                    (OstreeRepo *self,
    -                                GFile *dir_or_file,
    -                                gboolean skip_validation,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GFile *dir_or_file, + gboolean skip_validation, + GCancellable *cancellable, + GError **error);

    Given a directory representing an already-downloaded static delta on disk, apply it, generating a new commit. The directory must be named with the form "FROM-TO", where both are checksums, and it @@ -6205,7 +6205,7 @@ must contain a file named "superblock", along with at least one part.

    - + @@ -6225,9 +6225,9 @@ must contain a file named "superblock", along with at least one part.


    ostree_repo_traverse_new_reachable ()

    -
    GHashTable *
    +
    GHashTable *
     ostree_repo_traverse_new_reachable (void);
    -

    This hash table is a set of GVariant which can be accessed via +

    This hash table is a set of GVariant which can be accessed via ostree_object_name_deserialize().

    Returns

    @@ -6238,11 +6238,11 @@ ostree_repo_traverse_new_reachable (

    ostree_repo_traverse_new_parents ()

    -
    GHashTable *
    +
    GHashTable *
     ostree_repo_traverse_new_parents (void);
    -

    This hash table is a mapping from GVariant which can be accessed -via ostree_object_name_deserialize() to a GVariant containing either -a similar GVariant or and array of them, listing the parents of the key.

    +

    This hash table is a mapping from GVariant which can be accessed +via ostree_object_name_deserialize() to a GVariant containing either +a similar GVariant or and array of them, listing the parents of the key.

    Returns

    A new hash table.

    @@ -6255,8 +6255,8 @@ a similar

    ostree_repo_traverse_parents_get_commits ()

    char **
     ostree_repo_traverse_parents_get_commits
    -                               (GHashTable *parents,
    -                                GVariant *object);
    + (GHashTable *parents, + GVariant *object);

    Gets all the commits that a certain object belongs to, as recorded by a parents table gotten from ostree_repo_traverse_commit_union_with_parents.

    @@ -6270,13 +6270,13 @@ the commits the key belongs to.


    ostree_repo_traverse_commit ()

    -
    gboolean
    +
    gboolean
     ostree_repo_traverse_commit (OstreeRepo *repo,
                                  const char *commit_checksum,
                                  int maxdepth,
    -                             GHashTable **out_reachable,
    -                             GCancellable *cancellable,
    -                             GError **error);
    + GHashTable **out_reachable, + GCancellable *cancellable, + GError **error);

    Create a new set out_reachable containing all objects reachable from commit_checksum @@ -6328,13 +6328,13 @@ from commit_checksum


    ostree_repo_traverse_commit_union ()

    -
    gboolean
    +
    gboolean
     ostree_repo_traverse_commit_union (OstreeRepo *repo,
                                        const char *commit_checksum,
                                        int maxdepth,
    -                                   GHashTable *inout_reachable,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + GHashTable *inout_reachable, + GCancellable *cancellable, + GError **error);

    Update the set inout_reachable containing all objects reachable from commit_checksum @@ -6387,15 +6387,15 @@ from commit_checksum


    ostree_repo_traverse_commit_union_with_parents ()

    -
    gboolean
    +
    gboolean
     ostree_repo_traverse_commit_union_with_parents
                                    (OstreeRepo *repo,
                                     const char *commit_checksum,
                                     int maxdepth,
    -                                GHashTable *inout_reachable,
    -                                GHashTable *inout_parents,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GHashTable *inout_reachable, + GHashTable *inout_parents, + GCancellable *cancellable, + GError **error);

    Update the set inout_reachable containing all objects reachable from commit_checksum @@ -6555,13 +6555,13 @@ called if

    ostree_repo_commit_traverse_iter_init_commit ()

    -
    gboolean
    +
    gboolean
     ostree_repo_commit_traverse_iter_init_commit
                                    (OstreeRepoCommitTraverseIter *iter,
                                     OstreeRepo *repo,
    -                                GVariant *commit,
    +                                GVariant *commit,
                                     OstreeRepoCommitTraverseFlags flags,
    -                                GError **error);
    + GError **error);

    Initialize (in place) an iterator over the root of a commit object.

    Parameters

    @@ -6604,13 +6604,13 @@ ostree_repo_commit_traverse_iter_init_commit

    ostree_repo_commit_traverse_iter_init_dirtree ()

    -
    gboolean
    +
    gboolean
     ostree_repo_commit_traverse_iter_init_dirtree
                                    (OstreeRepoCommitTraverseIter *iter,
                                     OstreeRepo *repo,
    -                                GVariant *dirtree,
    +                                GVariant *dirtree,
                                     OstreeRepoCommitTraverseFlags flags,
    -                                GError **error);
    + GError **error);

    Initialize (in place) an iterator over a directory tree.

    Parameters

    @@ -6655,8 +6655,8 @@ ostree_repo_commit_traverse_iter_init_dirtree

    ostree_repo_commit_traverse_iter_next ()

    OstreeRepoCommitIterResult
     ostree_repo_commit_traverse_iter_next (OstreeRepoCommitTraverseIter *iter,
    -                                       GCancellable *cancellable,
    -                                       GError **error);
    + GCancellable *cancellable, + GError **error);

    Step the interator to the next item. Files will be returned first, then subdirectories. Call this in a loop; upon encountering OSTREE_REPO_COMMIT_ITER_RESULT_END, there will be no more files or @@ -6700,15 +6700,15 @@ program error to call any further API on iter


    ostree_repo_prune ()

    -
    gboolean
    +
    gboolean
     ostree_repo_prune (OstreeRepo *self,
                        OstreeRepoPruneFlags flags,
    -                   gint depth,
    -                   gint *out_objects_total,
    -                   gint *out_objects_pruned,
    -                   guint64 *out_pruned_object_size_total,
    -                   GCancellable *cancellable,
    -                   GError **error);
    + gint depth, + gint *out_objects_total, + gint *out_objects_pruned, + guint64 *out_pruned_object_size_total, + GCancellable *cancellable, + GError **error);

    Delete content from the repository. By default, this function will only delete "orphaned" objects not referred to by any commit. This can happen during a local commit operation, when we have written @@ -6778,11 +6778,11 @@ deleting them.


    ostree_repo_prune_static_deltas ()

    -
    gboolean
    +
    gboolean
     ostree_repo_prune_static_deltas (OstreeRepo *self,
                                      const char *commit,
    -                                 GCancellable *cancellable,
    -                                 GError **error);
    + GCancellable *cancellable, + GError **error);

    Prune static deltas, if COMMIT is specified then delete static delta files only targeting that commit; otherwise any static delta of non existing commits are deleted.

    @@ -6803,7 +6803,7 @@ deleted.

    - @@ -6824,12 +6824,12 @@ non existing commit.


    ostree_repo_traverse_reachable_refs ()

    -
    gboolean
    +
    gboolean
     ostree_repo_traverse_reachable_refs (OstreeRepo *self,
    -                                     guint depth,
    -                                     GHashTable *reachable,
    -                                     GCancellable *cancellable,
    -                                     GError **error);
    + guint depth, + GHashTable *reachable, + GCancellable *cancellable, + GError **error);

    Add all commit objects directly reachable via a ref to reachable .

    Locking: shared

    @@ -6875,14 +6875,14 @@ ostree_repo_traverse_reachable_refs (

    ostree_repo_prune_from_reachable ()

    -
    gboolean
    +
    gboolean
     ostree_repo_prune_from_reachable (OstreeRepo *self,
                                       OstreeRepoPruneOptions *options,
    -                                  gint *out_objects_total,
    -                                  gint *out_objects_pruned,
    -                                  guint64 *out_pruned_object_size_total,
    -                                  GCancellable *cancellable,
    -                                  GError **error);
    + gint *out_objects_total, + gint *out_objects_pruned, + guint64 *out_pruned_object_size_total, + GCancellable *cancellable, + GError **error);

    Delete content from the repository. This function is the "backend" half of the higher level ostree_repo_prune(). To use this function, you determine the root set yourself, and this function finds all other @@ -6944,14 +6944,14 @@ statistics on objects that would be deleted, without actually deleting them.


    ostree_repo_pull ()

    -
    gboolean
    +
    gboolean
     ostree_repo_pull (OstreeRepo *self,
                       const char *remote_name,
                       char **refs_to_fetch,
                       OstreeRepoPullFlags flags,
                       OstreeAsyncProgress *progress,
    -                  GCancellable *cancellable,
    -                  GError **error);
    + GCancellable *cancellable, + GError **error);

    Connect to the remote repository, fetching the specified set of refs refs_to_fetch . For each ref that is changed, download the @@ -6961,7 +6961,7 @@ on disk in self

    If flags contains OSTREE_REPO_PULL_FLAGS_MIRROR, and the refs_to_fetch - is NULL, and the remote repository contains a + is NULL, and the remote repository contains a summary file, then all refs will be fetched.

    If flags contains OSTREE_REPO_PULL_FLAGS_COMMIT_ONLY, then only the @@ -6969,7 +6969,7 @@ metadata for the commits in refs_to_fetch

    Warning: This API will iterate the thread default main context, which is a bug, but kept for compatibility reasons. If you want to -avoid this, use g_main_context_push_thread_default() to push a new +avoid this, use g_main_context_push_thread_default() to push a new one around this call.

    Parameters

    @@ -6992,7 +6992,7 @@ one around this call.

    - + @@ -7022,15 +7022,15 @@ one around this call.


    ostree_repo_pull_one_dir ()

    -
    gboolean
    +
    gboolean
     ostree_repo_pull_one_dir (OstreeRepo *self,
                               const char *remote_name,
                               const char *dir_to_pull,
                               char **refs_to_fetch,
                               OstreeRepoPullFlags flags,
                               OstreeAsyncProgress *progress,
    -                          GCancellable *cancellable,
    -                          GError **error);
    + GCancellable *cancellable, + GError **error);

    This is similar to ostree_repo_pull(), but only fetches a single subpath.

    @@ -7059,7 +7059,7 @@ subpath.

    - + @@ -7089,13 +7089,13 @@ subpath.


    ostree_repo_pull_with_options ()

    -
    gboolean
    +
    gboolean
     ostree_repo_pull_with_options (OstreeRepo *self,
                                    const char *remote_name_or_baseurl,
    -                               GVariant *options,
    +                               GVariant *options,
                                    OstreeAsyncProgress *progress,
    -                               GCancellable *cancellable,
    -                               GError **error);
    + GCancellable *cancellable, + GError **error);

    Like ostree_repo_pull(), but supports an extensible set of flags. The following are currently defined:

      @@ -7174,7 +7174,7 @@ means return errors without retrying

      void
       ostree_repo_pull_default_console_progress_changed
                                      (OstreeAsyncProgress *progress,
      -                                gpointer user_data);
      + gpointer user_data);

      Convenient "changed" callback for use with ostree_async_progress_new_and_connect() when pulling from a remote repository.

      @@ -7213,13 +7213,13 @@ and user_data

      ostree_repo_sign_commit ()

      -
      gboolean
      +
      gboolean
       ostree_repo_sign_commit (OstreeRepo *self,
      -                         const gchar *commit_checksum,
      -                         const gchar *key_id,
      -                         const gchar *homedir,
      -                         GCancellable *cancellable,
      -                         GError **error);
      + const gchar *commit_checksum, + const gchar *key_id, + const gchar *homedir, + GCancellable *cancellable, + GError **error);

      Add a GPG signature to a commit.

      Parameters

      @@ -7247,17 +7247,17 @@ ostree_repo_sign_commit (

      homedir

      -
    + - + - + @@ -7267,12 +7267,12 @@ ostree_repo_sign_commit (

    ostree_repo_append_gpg_signature ()

    -
    gboolean
    +
    gboolean
     ostree_repo_append_gpg_signature (OstreeRepo *self,
    -                                  const gchar *commit_checksum,
    -                                  GBytes *signature_bytes,
    -                                  GCancellable *cancellable,
    -                                  GError **error);
    + const gchar *commit_checksum, + GBytes *signature_bytes, + GCancellable *cancellable, + GError **error);

    Append a GPG signature to a commit.

    Parameters

    @@ -7300,12 +7300,12 @@ ostree_repo_append_gpg_signature (
    - + - + @@ -7315,12 +7315,12 @@ ostree_repo_append_gpg_signature (

    ostree_repo_add_gpg_signature_summary ()

    -
    gboolean
    +
    gboolean
     ostree_repo_add_gpg_signature_summary (OstreeRepo *self,
    -                                       const gchar **key_id,
    -                                       const gchar *homedir,
    -                                       GCancellable *cancellable,
    -                                       GError **error);
    + const gchar **key_id, + const gchar *homedir, + GCancellable *cancellable, + GError **error);

    Add a GPG signature to a summary file.

    Parameters

    @@ -7343,17 +7343,17 @@ ostree_repo_add_gpg_signature_summary (

    homedir

    -
    + - + - + @@ -7365,20 +7365,20 @@ ostree_repo_add_gpg_signature_summary (

    ostree_repo_gpg_verify_data ()

    OstreeGpgVerifyResult *
     ostree_repo_gpg_verify_data (OstreeRepo *self,
    -                             const gchar *remote_name,
    -                             GBytes *data,
    -                             GBytes *signatures,
    -                             GFile *keyringdir,
    -                             GFile *extra_keyring,
    -                             GCancellable *cancellable,
    -                             GError **error);
    + const gchar *remote_name, + GBytes *data, + GBytes *signatures, + GFile *keyringdir, + GFile *extra_keyring, + GCancellable *cancellable, + GError **error);

    Verify signatures for data using GPG keys in the keyring for remote_name , and return an OstreeGpgVerifyResult.

    The remote_name - parameter can be NULL. In that case it will do + parameter can be NULL. In that case it will do the verifications using GPG keys in the keyrings of all remotes.

    Parameters

    @@ -7401,12 +7401,12 @@ the verifications using GPG keys in the keyrings of all remotes.

    - + - + @@ -7434,20 +7434,20 @@ the verifications using GPG keys in the keyrings of all remotes.

    Returns

    -

    an OstreeGpgVerifyResult, or NULL on error.

    +

    an OstreeGpgVerifyResult, or NULL on error.

    [transfer full]


    ostree_repo_verify_commit ()

    -
    gboolean
    +
    gboolean
     ostree_repo_verify_commit (OstreeRepo *self,
    -                           const gchar *commit_checksum,
    -                           GFile *keyringdir,
    -                           GFile *extra_keyring,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + const gchar *commit_checksum, + GFile *keyringdir, + GFile *extra_keyring, + GCancellable *cancellable, + GError **error);

    Check for a valid GPG signature on commit named by the ASCII checksum commit_checksum .

    @@ -7495,7 +7495,7 @@ checksum commit_checksum

    Returns

    -

    TRUE if there was a GPG signature from a trusted keyring, otherwise FALSE

    +

    TRUE if there was a GPG signature from a trusted keyring, otherwise FALSE


    @@ -7503,11 +7503,11 @@ checksum commit_checksum

    ostree_repo_verify_commit_ext ()

    OstreeGpgVerifyResult *
     ostree_repo_verify_commit_ext (OstreeRepo *self,
    -                               const gchar *commit_checksum,
    -                               GFile *keyringdir,
    -                               GFile *extra_keyring,
    -                               GCancellable *cancellable,
    -                               GError **error);
    + const gchar *commit_checksum, + GFile *keyringdir, + GFile *extra_keyring, + GCancellable *cancellable, + GError **error);

    Read GPG signature(s) on the commit named by the ASCII checksum commit_checksum and return detailed results.

    @@ -7555,7 +7555,7 @@ ostree_repo_verify_commit_ext (

    Returns

    -

    an OstreeGpgVerifyResult, or NULL on error.

    +

    an OstreeGpgVerifyResult, or NULL on error.

    [transfer full]

    @@ -7564,10 +7564,10 @@ ostree_repo_verify_commit_ext (

    ostree_repo_verify_commit_for_remote ()

    OstreeGpgVerifyResult *
     ostree_repo_verify_commit_for_remote (OstreeRepo *self,
    -                                      const gchar *commit_checksum,
    -                                      const gchar *remote_name,
    -                                      GCancellable *cancellable,
    -                                      GError **error);
    + const gchar *commit_checksum, + const gchar *remote_name, + GCancellable *cancellable, + GError **error);

    Read GPG signature(s) on the commit named by the ASCII checksum commit_checksum and return detailed results, based on the keyring @@ -7612,7 +7612,7 @@ configured for remote

    Returns

    -

    an OstreeGpgVerifyResult, or NULL on error.

    +

    an OstreeGpgVerifyResult, or NULL on error.

    [transfer full]

    @@ -7622,10 +7622,10 @@ configured for remote
    OstreeGpgVerifyResult *
     ostree_repo_verify_summary (OstreeRepo *self,
                                 const char *remote_name,
    -                            GBytes *summary,
    -                            GBytes *signatures,
    -                            GCancellable *cancellable,
    -                            GError **error);
    + GBytes *summary, + GBytes *signatures, + GCancellable *cancellable, + GError **error);

    Verify signatures for summary data using GPG keys in the keyring for @@ -7652,12 +7652,12 @@ ostree_repo_verify_summary (

    summary

    -
    + - + @@ -7675,18 +7675,18 @@ ostree_repo_verify_summary (

    Returns

    -

    an OstreeGpgVerifyResult, or NULL on error.

    +

    an OstreeGpgVerifyResult, or NULL on error.

    [transfer full]


    ostree_repo_regenerate_summary ()

    -
    gboolean
    +
    gboolean
     ostree_repo_regenerate_summary (OstreeRepo *self,
    -                                GVariant *additional_metadata,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GVariant *additional_metadata, + GCancellable *cancellable, + GError **error);

    An OSTree repository can contain a high level "summary" file that describes the available branches and other metadata.

    If the timetable for making commits and updating the summary file is fairly @@ -7717,7 +7717,7 @@ lexicographic order.

    - + @@ -7868,52 +7868,52 @@ interesting for reporting purposes.

    - + - + - + - + - + - + - + - + - + @@ -8273,7 +8273,7 @@ supercedes previous separate enumeration usage in

    OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE

    #define OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE (G_VARIANT_TYPE ("(bas)")
     
    -

    b - TRUE if object is available "loose" +

    b - TRUE if object is available "loose" as - List of pack file checksums in which this object appears


    diff --git a/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html b/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html index 0d1fdae4..3ecd263b 100644 --- a/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html +++ b/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html @@ -3,7 +3,7 @@ Progress notification system for asynchronous operations: OSTree API references - + @@ -73,7 +73,7 @@
    - +ostree_async_progress_get (progress, + "outstanding-fetches", "u", &outstanding_fetches, + "bytes-received", "t", &bytes_received, + "status", "s", &status, + "refs", "@a{ss}", &refs_variant, + NULL);

    from

    ASCII SHA256 checksum of origin, or NULL

    ASCII SHA256 checksum of origin, or NULL

     

    skip_validation

    If TRUE, assume data integrity

    If TRUE, assume data integrity

     

    commit

    ASCII SHA256 checksum for commit, or NULL for each +

    ASCII SHA256 checksum for commit, or NULL for each non existing commit.

    [allow-none]

    refs_to_fetch

    Optional list of refs; if NULL, fetch all configured refs.

    Optional list of refs; if NULL, fetch all configured refs.

    [array zero-terminated=1][element-type utf8][allow-none]

    refs_to_fetch

    Optional list of refs; if NULL, fetch all configured refs.

    Optional list of refs; if NULL, fetch all configured refs.

    [array zero-terminated=1][element-type utf8][allow-none]

    GPG home directory, or NULL.

    GPG home directory, or NULL.

    [allow-none]

    cancellable

    A GCancellable

    A GCancellable

     

    error

    a GError

    a GError

     

    cancellable

    A GCancellable

    A GCancellable

     

    error

    a GError

    a GError

     

    GPG home directory, or NULL.

    GPG home directory, or NULL.

    [allow-none]

    cancellable

    A GCancellable

    A GCancellable

     

    error

    a GError

    a GError

     

    data

    Data as a GBytes

    Data as a GBytes

     

    signatures

    Signatures as a GBytes

    Signatures as a GBytes

     

    Summary data as a GBytes

    Summary data as a GBytes

     

    signatures

    Summary signatures as a GBytes

    Summary signatures as a GBytes

     

    additional_metadata

    A GVariant of type a{sv}, or NULL.

    A GVariant of type a{sv}, or NULL.

    [allow-none]

    guint metadata_objects_total;

    guint metadata_objects_total;

    The total number of metadata objects in the repository after this transaction has completed.

     

    guint metadata_objects_written;

    guint metadata_objects_written;

    The number of metadata objects that were written to the repository in this transaction.

     

    guint content_objects_total;

    guint content_objects_total;

    The total number of content objects in the repository after this transaction has completed.

     

    guint content_objects_written;

    guint content_objects_written;

    The number of content objects that were written to the repository in this transaction.

     

    guint64 content_bytes_written;

    guint64 content_bytes_written;

    The amount of data added to the repository, in bytes, counting only content objects.

     

    guint64 padding1;

    guint64 padding1;

    reserved

     

    guint64 padding2;

    guint64 padding2;

    reserved

     

    guint64 padding3;

    guint64 padding3;

    reserved

     

    guint64 padding4;

    guint64 padding4;

    reserved

     
    -GVariant * +GVariant * ostree_async_progress_get_variant () @@ -81,7 +81,7 @@
    -guint +guint ostree_async_progress_get_uint () @@ -89,7 +89,7 @@
    -guint64 +guint64 ostree_async_progress_get_uint64 () @@ -171,7 +171,7 @@ handles thread safety, ensuring that the progress change notification occurs in the thread-default context of the calling operation.

    The ostree_async_progress_get_status() and ostree_async_progress_set_status() -methods get and set a well-known status key of type G_VARIANT_TYPE_STRING. +methods get and set a well-known status key of type G_VARIANT_TYPE_STRING. This key may be accessed using the other OstreeAsyncProgress methods, but it must always have the correct type.

    @@ -192,7 +192,7 @@ ostree_async_progress_new (void

    ostree_async_progress_new_and_connect ()

    OstreeAsyncProgress *
     ostree_async_progress_new_and_connect (void (*changed) (OstreeAsyncProgress *self, gpointer user_data),
    -                                       gpointer user_data);
    + gpointer user_data);
    @@ -200,7 +200,7 @@ ostree_async_progress_new_and_connect (char * ostree_async_progress_get_status (OstreeAsyncProgress *self);

    Get the human-readable status string from the OstreeAsyncProgress. This -operation is thread-safe. The retuned value may be NULL if no status is +operation is thread-safe. The retuned value may be NULL if no status is set.

    This is a convenience function to get the well-known status key.

    @@ -220,7 +220,7 @@ set.

    Returns

    -

    the current status, or NULL if none is set.

    +

    the current status, or NULL if none is set.

    [transfer full][nullable]

    Since: 2017.6

    @@ -233,9 +233,9 @@ ostree_async_progress_get (...);

    Get the values corresponding to zero or more keys from the OstreeAsyncProgress. Each key is specified in @... as the key name, followed -by a GVariant format string, followed by the necessary arguments for that -format string, just as for g_variant_get(). After those arguments is the -next key name. The varargs list must be NULL-terminated.

    +by a GVariant format string, followed by the necessary arguments for that +format string, just as for g_variant_get(). After those arguments is the +next key name. The varargs list must be NULL-terminated.

    Each format string must make deep copies of its value, as the values stored in the OstreeAsyncProgress may be freed from another thread after this function returns.

    @@ -255,17 +255,17 @@ function returns.

    9 10 11
    guint32 outstanding_fetches;
    -guint64 bytes_received;
    -g_autofree gchar *status = NULL;
    -g_autoptr(GVariant) refs_variant = NULL;
    +        
    guint32 outstanding_fetches;
    +guint64 bytes_received;
    +g_autofree gchar *status = NULL;
    +g_autoptr(GVariant) refs_variant = NULL;
     
    -ostree_async_progress_get (progress,
    -                           "outstanding-fetches", "u", &outstanding_fetches,
    -                           "bytes-received", "t", &bytes_received,
    -                           "status", "s", &status,
    -                           "refs", "@a{ss}", &refs_variant,
    -                           NULL);
    @@ -288,7 +288,7 @@ g_autofree gchar *status

    ...

    key name, format string, GVariant return locations, …, followed by NULL

    key name, format string, GVariant return locations, …, followed by NULL

     

    new status string, or NULL to clear the status.

    new status string, or NULL to clear the status.

    [nullable]
    guint32 outstanding_fetches = 15;
    -guint64 bytes_received = 1000;
    +        
    guint32 outstanding_fetches = 15;
    +guint64 bytes_received = 1000;
     
    -ostree_async_progress_set (progress,
    -                           "outstanding-fetches", "u", outstanding_fetches,
    -                           "bytes-received", "t", bytes_received,
    -                           "status", "s", "Updated status",
    -                           "refs", "@a{ss}", g_variant_new_parsed ("@a{ss} {}"),
    -                           NULL);
    @@ -440,7 +440,7 @@ guint64 bytes_received = 10

    ...

    -

    key name, format string, GVariant parameters, …, followed by NULL

    +

    key name, format string, GVariant parameters, …, followed by NULL

      @@ -454,13 +454,13 @@ guint64 bytes_received = 10
    void
     ostree_async_progress_set_variant (OstreeAsyncProgress *self,
                                        const char *key,
    -                                   GVariant *value);
    + GVariant *value);

    Assign a new value to the given key , replacing any existing value. The operation is thread-safe. value may be a floating reference; -g_variant_ref_sink() will be called on it.

    +g_variant_ref_sink() will be called on it.

    Any watchers of the OstreeAsyncProgress will be notified of the change if value differs from the existing value for key @@ -501,7 +501,7 @@ operation is thread-safe. value

    void
     ostree_async_progress_set_uint (OstreeAsyncProgress *self,
                                     const char *key,
    -                                guint value);
    + guint value);

    @@ -509,7 +509,7 @@ ostree_async_progress_set_uint (void ostree_async_progress_set_uint64 (OstreeAsyncProgress *self, const char *key, - guint64 value); + guint64 value);

    diff --git a/apidoc/html/ostree-Root-partition-mount-point.html b/apidoc/html/ostree-Root-partition-mount-point.html index b73389eb..0c08966c 100644 --- a/apidoc/html/ostree-Root-partition-mount-point.html +++ b/apidoc/html/ostree-Root-partition-mount-point.html @@ -3,7 +3,7 @@ Root partition mount point: OSTree API references - + @@ -57,7 +57,7 @@ -GFile * +GFile * ostree_sysroot_get_path () @@ -65,7 +65,7 @@ -gboolean +gboolean ostree_sysroot_load () @@ -73,7 +73,7 @@ -gboolean +gboolean ostree_sysroot_load_if_changed () @@ -81,7 +81,7 @@ -gboolean +gboolean ostree_sysroot_lock () @@ -89,7 +89,7 @@ -gboolean +gboolean ostree_sysroot_try_lock () @@ -105,7 +105,7 @@ -gboolean +gboolean ostree_sysroot_lock_finish () @@ -137,7 +137,7 @@ -gboolean +gboolean ostree_sysroot_ensure_initialized () @@ -161,7 +161,7 @@ -GPtrArray * +GPtrArray * ostree_sysroot_get_deployments () @@ -177,7 +177,7 @@ -GFile * +GFile * ostree_sysroot_get_deployment_directory () @@ -193,7 +193,7 @@ -GFile * +GFile * ostree_sysroot_get_deployment_origin_path () @@ -201,7 +201,7 @@ -gboolean +gboolean ostree_sysroot_cleanup () @@ -209,7 +209,7 @@ -gboolean +gboolean ostree_sysroot_prepare_cleanup () @@ -217,7 +217,7 @@ -gboolean +gboolean ostree_sysroot_cleanup_prune_repo () @@ -233,7 +233,7 @@ -gboolean +gboolean ostree_sysroot_get_repo () @@ -249,7 +249,7 @@ -gboolean +gboolean ostree_sysroot_init_osname () @@ -257,7 +257,7 @@ -gboolean +gboolean ostree_sysroot_deployment_set_kargs () @@ -265,7 +265,7 @@ -gboolean +gboolean ostree_sysroot_deployment_set_mutable () @@ -273,7 +273,7 @@ -gboolean +gboolean ostree_sysroot_deployment_unlock () @@ -281,7 +281,7 @@ -gboolean +gboolean ostree_sysroot_deployment_set_pinned () @@ -289,7 +289,7 @@ -gboolean +gboolean ostree_sysroot_write_deployments () @@ -297,7 +297,7 @@ -gboolean +gboolean ostree_sysroot_write_deployments_with_options () @@ -305,7 +305,7 @@ -gboolean +gboolean ostree_sysroot_write_origin_file () @@ -313,7 +313,7 @@ -gboolean +gboolean ostree_sysroot_stage_tree () @@ -321,7 +321,7 @@ -gboolean +gboolean ostree_sysroot_deploy_tree () @@ -345,7 +345,7 @@ -GKeyFile * +GKeyFile * ostree_sysroot_origin_new_from_refspec () @@ -353,7 +353,7 @@ -gboolean +gboolean ostree_sysroot_simple_write_deployment () @@ -396,10 +396,10 @@ perform locking externally.

    ostree_sysroot_new ()

    OstreeSysroot *
    -ostree_sysroot_new (GFile *path);
    +ostree_sysroot_new (GFile *path);

    Create a new OstreeSysroot object for the sysroot at path . If path - is NULL, + is NULL, the current visible root file system is used, equivalent to ostree_sysroot_new_default().

    @@ -412,7 +412,7 @@ the current visible root file system is used, equivalent to

    path

    -

    Path to a system root directory, or NULL to use the +

    Path to a system root directory, or NULL to use the current visible root file system.

    [allow-none] @@ -439,7 +439,7 @@ ostree_sysroot_new_default (void<

    ostree_sysroot_get_path ()

    -
    GFile *
    +
    GFile *
     ostree_sysroot_get_path (OstreeSysroot *self);

    Returns

    @@ -450,10 +450,10 @@ ostree_sysroot_get_path (

    ostree_sysroot_load ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_load (OstreeSysroot *self,
    -                     GCancellable *cancellable,
    -                     GError **error);
    + GCancellable *cancellable, + GError **error);

    Load deployment list, bootversion, and subbootversion from the rootfs self .

    @@ -488,18 +488,18 @@ rootfs self

    ostree_sysroot_load_if_changed ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_load_if_changed (OstreeSysroot *self,
    -                                gboolean *out_changed,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + gboolean *out_changed, + GCancellable *cancellable, + GError **error);

    ostree_sysroot_lock ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_lock (OstreeSysroot *self,
    -                     GError **error);
    + GError **error);

    Acquire an exclusive multi-process write lock for self . This call blocks until the lock has been acquired. The lock is not @@ -533,15 +533,15 @@ be released if self


    ostree_sysroot_try_lock ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_try_lock (OstreeSysroot *self,
    -                         gboolean *out_acquired,
    -                         GError **error);
    + gboolean *out_acquired, + GError **error);

    Try to acquire an exclusive multi-process write lock for self . If another process holds the lock, this function will return immediately, setting out_acquired - to FALSE, and returning TRUE + to FALSE, and returning TRUE (and no error).

    Release the lock with ostree_sysroot_unlock(). The lock will also be released if self @@ -579,9 +579,9 @@ be released if self

    ostree_sysroot_lock_async ()

    void
     ostree_sysroot_lock_async (OstreeSysroot *self,
    -                           GCancellable *cancellable,
    -                           GAsyncReadyCallback callback,
    -                           gpointer user_data);
    + GCancellable *cancellable, + GAsyncReadyCallback callback, + gpointer user_data);

    An asynchronous version of ostree_sysroot_lock().

    Parameters

    @@ -619,10 +619,10 @@ ostree_sysroot_lock_async (

    ostree_sysroot_lock_finish ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_lock_finish (OstreeSysroot *self,
    -                            GAsyncResult *result,
    -                            GError **error);
    + GAsyncResult *result, + GError **error);

    Call when ostree_sysroot_lock_async() is ready.

    Parameters

    @@ -734,10 +734,10 @@ calling this function.


    ostree_sysroot_ensure_initialized ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_ensure_initialized (OstreeSysroot *self,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + GCancellable *cancellable, + GError **error);

    Ensure that self is set up as a valid rootfs, by creating /ostree/repo, among other things.

    @@ -784,7 +784,7 @@ ostree_sysroot_get_subbootversion (

    ostree_sysroot_get_deployments ()

    -
    GPtrArray *
    +
    GPtrArray *
     ostree_sysroot_get_deployments (OstreeSysroot *self);

    Parameters

    @@ -829,14 +829,14 @@ ostree_sysroot_get_booted_deployment (

    Returns

    -

    The currently booted deployment, or NULL if none.

    +

    The currently booted deployment, or NULL if none.

    [transfer none]


    ostree_sysroot_get_deployment_directory ()

    -
    GFile *
    +
    GFile *
     ostree_sysroot_get_deployment_directory
                                    (OstreeSysroot *self,
                                     OstreeDeployment *deployment);
    @@ -908,9 +908,9 @@ or concatenate it with the full

    ostree_sysroot_get_deployment_origin_path ()

    -
    GFile *
    +
    GFile *
     ostree_sysroot_get_deployment_origin_path
    -                               (GFile *deployment_path);
    + (GFile *deployment_path);

    Parameters

    @@ -935,10 +935,10 @@ ostree_sysroot_get_deployment_origin_path

    ostree_sysroot_cleanup ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_cleanup (OstreeSysroot *self,
    -                        GCancellable *cancellable,
    -                        GError **error);
    + GCancellable *cancellable, + GError **error);

    Delete any state that resulted from a partially completed transaction, such as incomplete deployments.

    @@ -972,10 +972,10 @@ transaction, such as incomplete deployments.


    ostree_sysroot_prepare_cleanup ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_prepare_cleanup (OstreeSysroot *self,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GCancellable *cancellable, + GError **error);

    Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments and old boot versions, but does NOT prune the repository.

    @@ -1009,14 +1009,14 @@ and old boot versions, but does NOT prune the repository.


    ostree_sysroot_cleanup_prune_repo ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_cleanup_prune_repo (OstreeSysroot *sysroot,
                                        OstreeRepoPruneOptions *options,
    -                                   gint *out_objects_total,
    -                                   gint *out_objects_pruned,
    -                                   guint64 *out_pruned_object_size_total,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + gint *out_objects_total, + gint *out_objects_pruned, + guint64 *out_pruned_object_size_total, + GCancellable *cancellable, + GError **error);

    Prune the system repository. This is a thin wrapper around ostree_repo_prune_from_reachable(); the primary addition is that this function automatically gathers @@ -1107,11 +1107,11 @@ has been invoked successfully.


    ostree_sysroot_get_repo ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_get_repo (OstreeSysroot *self,
                              OstreeRepo **out_repo,
    -                         GCancellable *cancellable,
    -                         GError **error);
    + GCancellable *cancellable, + GError **error);

    Retrieve the OSTree repository in sysroot self . The repo is guaranteed to be open (see ostree_repo_open()).

    @@ -1150,7 +1150,7 @@ ostree_sysroot_get_repo (

    Returns

    -

    TRUE on success, FALSE otherwise

    +

    TRUE on success, FALSE otherwise


    @@ -1175,18 +1175,18 @@ ostree_sysroot_get_staged_deployment (

    Returns

    -

    The currently staged deployment, or NULL if none.

    +

    The currently staged deployment, or NULL if none.

    [transfer none]


    ostree_sysroot_init_osname ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_init_osname (OstreeSysroot *self,
                                 const char *osname,
    -                            GCancellable *cancellable,
    -                            GError **error);
    + GCancellable *cancellable, + GError **error);

    Initialize the directory structure for an "osname", which is a group of operating system deployments, with a shared /var. One is required for generating a deployment.

    @@ -1226,12 +1226,12 @@ is required for generating a deployment.


    ostree_sysroot_deployment_set_kargs ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_deployment_set_kargs (OstreeSysroot *self,
                                          OstreeDeployment *deployment,
                                          char **new_kargs,
    -                                     GCancellable *cancellable,
    -                                     GError **error);
    + GCancellable *cancellable, + GError **error);

    Entirely replace the kernel arguments of deployment with the values in new_kargs @@ -1277,12 +1277,12 @@ values in new_kargs


    ostree_sysroot_deployment_set_mutable ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_deployment_set_mutable (OstreeSysroot *self,
                                            OstreeDeployment *deployment,
    -                                       gboolean is_mutable,
    -                                       GCancellable *cancellable,
    -                                       GError **error);
    + gboolean is_mutable, + GCancellable *cancellable, + GError **error);

    By default, deployment directories are not mutable. This function will allow making them temporarily mutable, for example to allow layering additional non-OSTree content.

    @@ -1327,12 +1327,12 @@ layering additional non-OSTree content.


    ostree_sysroot_deployment_unlock ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_deployment_unlock (OstreeSysroot *self,
                                       OstreeDeployment *deployment,
                                       OstreeDeploymentUnlockedState unlocked_state,
    -                                  GCancellable *cancellable,
    -                                  GError **error);
    + GCancellable *cancellable, + GError **error);

    Configure the target deployment deployment such that it is writable. There are multiple modes, essentially differing @@ -1380,11 +1380,11 @@ across reboots.


    ostree_sysroot_deployment_set_pinned ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_deployment_set_pinned (OstreeSysroot *self,
                                           OstreeDeployment *deployment,
    -                                      gboolean is_pinned,
    -                                      GError **error);
    + gboolean is_pinned, + GError **error);

    By default, deployments may be subject to garbage collection. Typical uses of libostree only retain at most 2 deployments. If is_pinned is TRUE, a @@ -1430,11 +1430,11 @@ is already in the desired pinning state.


    ostree_sysroot_write_deployments ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_write_deployments (OstreeSysroot *self,
    -                                  GPtrArray *new_deployments,
    -                                  GCancellable *cancellable,
    -                                  GError **error);
    + GPtrArray *new_deployments, + GCancellable *cancellable, + GError **error);

    Older version of ostree_sysroot_write_deployments_with_options(). This version will perform post-deployment cleanup by default.

    @@ -1473,13 +1473,13 @@ version will perform post-deployment cleanup by default.


    ostree_sysroot_write_deployments_with_options ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_write_deployments_with_options
                                    (OstreeSysroot *self,
    -                                GPtrArray *new_deployments,
    +                                GPtrArray *new_deployments,
                                     OstreeSysrootWriteDeploymentsOpts *opts,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GCancellable *cancellable, + GError **error);

    Assuming new_deployments have already been deployed in place on disk via ostree_sysroot_deploy_tree(), atomically update bootloader configuration. By @@ -1529,17 +1529,17 @@ if for example you want to control pruning of the repository.


    ostree_sysroot_write_origin_file ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_write_origin_file (OstreeSysroot *sysroot,
                                       OstreeDeployment *deployment,
    -                                  GKeyFile *new_origin,
    -                                  GCancellable *cancellable,
    -                                  GError **error);
    + GKeyFile *new_origin, + GCancellable *cancellable, + GError **error);

    Immediately replace the origin file of the referenced deployment with the contents of new_origin . If new_origin - is NULL, + is NULL, this function will write the current origin of deployment .

    @@ -1583,16 +1583,16 @@ this function will write the current origin of deplo

    ostree_sysroot_stage_tree ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_stage_tree (OstreeSysroot *self,
                                const char *osname,
                                const char *revision,
    -                           GKeyFile *origin,
    +                           GKeyFile *origin,
                                OstreeDeployment *merge_deployment,
                                char **override_kernel_argv,
                                OstreeDeployment **out_new_deployment,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GCancellable *cancellable, + GError **error);

    Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS shutdown time.

    @@ -1631,7 +1631,7 @@ shutdown time.

    - + @@ -1656,16 +1656,16 @@ shutdown time.


    ostree_sysroot_deploy_tree ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_deploy_tree (OstreeSysroot *self,
                                 const char *osname,
                                 const char *revision,
    -                            GKeyFile *origin,
    +                            GKeyFile *origin,
                                 OstreeDeployment *provided_merge_deployment,
                                 char **override_kernel_argv,
                                 OstreeDeployment **out_new_deployment,
    -                            GCancellable *cancellable,
    -                            GError **error);
    + GCancellable *cancellable, + GError **error);

    Check out deployment tree with revision revision , performing a 3 way merge with provided_merge_deployment @@ -1708,7 +1708,7 @@ way merge with provided_merge_deployment

    - + @@ -1775,7 +1775,7 @@ ostree_sysroot_query_deployments_for (OstreeDeployment **out_pending, OstreeDeployment **out_rollback);

    Find the pending and rollback deployments for osname -. Pass NULL for osname +. Pass NULL for osname to use the booted deployment's osname. By default, pending deployment is the first deployment in the order that matches osname @@ -1820,7 +1820,7 @@ we're not looking at the booted deployment.


    ostree_sysroot_origin_new_from_refspec ()

    -
    GKeyFile *
    +
    GKeyFile *
     ostree_sysroot_origin_new_from_refspec
                                    (OstreeSysroot *self,
                                     const char *refspec);
    @@ -1856,15 +1856,15 @@ as an origin.


    ostree_sysroot_simple_write_deployment ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_simple_write_deployment
                                    (OstreeSysroot *sysroot,
                                     const char *osname,
                                     OstreeDeployment *new_deployment,
                                     OstreeDeployment *merge_deployment,
                                     OstreeSysrootSimpleWriteDeploymentFlags flags,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GCancellable *cancellable, + GError **error);

    Prepend new_deployment to the list of deployments, commit, and cleanup. By default, all other deployments for the given osname diff --git a/apidoc/html/ostree-SELinux-policy-management.html b/apidoc/html/ostree-SELinux-policy-management.html index 06f77751..bbe7fe19 100644 --- a/apidoc/html/ostree-SELinux-policy-management.html +++ b/apidoc/html/ostree-SELinux-policy-management.html @@ -3,7 +3,7 @@ SELinux policy management: OSTree API references - + @@ -57,7 +57,7 @@

    override_kernel_argv

    Use these as kernel arguments; if NULL, inherit options from provided_merge_deployment.

    Use these as kernel arguments; if NULL, inherit options from provided_merge_deployment.

    [allow-none][array zero-terminated=1][element-type utf8]

    override_kernel_argv

    Use these as kernel arguments; if NULL, inherit options from provided_merge_deployment.

    Use these as kernel arguments; if NULL, inherit options from provided_merge_deployment.

    [allow-none][array zero-terminated=1][element-type utf8]
    -GFile * +GFile * ostree_sepolicy_get_path () @@ -72,7 +72,7 @@
    -gboolean +gboolean ostree_sepolicy_get_label () @@ -87,7 +87,7 @@
    -gboolean +gboolean ostree_sepolicy_restorecon () @@ -95,7 +95,7 @@
    -gboolean +gboolean ostree_sepolicy_setfscreatecon () @@ -141,9 +141,9 @@ root and perform labeling.

    ostree_sepolicy_new ()

    OstreeSePolicy *
    -ostree_sepolicy_new (GFile *path,
    -                     GCancellable *cancellable,
    -                     GError **error);
    +ostree_sepolicy_new (GFile *path, + GCancellable *cancellable, + GError **error);

    Parameters

    @@ -183,8 +183,8 @@ ostree_sepolicy_new (

    ostree_sepolicy_new_at ()

    OstreeSePolicy *
     ostree_sepolicy_new_at (int rootfs_dfd,
    -                        GCancellable *cancellable,
    -                        GError **error);
    + GCancellable *cancellable, + GError **error);

    Parameters

    @@ -222,7 +222,7 @@ ostree_sepolicy_new_at (int

    ostree_sepolicy_get_path ()

    -
    GFile *
    +
    GFile *
     ostree_sepolicy_get_path (OstreeSePolicy *self);

    Returns

    @@ -244,18 +244,18 @@ ostree_sepolicy_get_name (

    ostree_sepolicy_get_label ()

    -
    gboolean
    +
    gboolean
     ostree_sepolicy_get_label (OstreeSePolicy *self,
                                const char *relpath,
    -                           guint32 unix_mode,
    +                           guint32 unix_mode,
                                char **out_label,
    -                           GCancellable *cancellable,
    -                           GError **error);
    + GCancellable *cancellable, + GError **error);

    Store in out_label the security context for the given relpath and mode unix_mode -. If the policy does not specify a label, NULL +. If the policy does not specify a label, NULL will be returned.

    Parameters

    @@ -314,15 +314,15 @@ ostree_sepolicy_get_csum (

    ostree_sepolicy_restorecon ()

    -
    gboolean
    +
    gboolean
     ostree_sepolicy_restorecon (OstreeSePolicy *self,
                                 const char *path,
    -                            GFileInfo *info,
    -                            GFile *target,
    +                            GFileInfo *info,
    +                            GFile *target,
                                 OstreeSePolicyRestoreconFlags flags,
                                 char **out_new_label,
    -                            GCancellable *cancellable,
    -                            GError **error);
    + GCancellable *cancellable, + GError **error);

    Reset the security context of target based on the SELinux policy.

    @@ -361,7 +361,7 @@ ostree_sepolicy_restorecon (

    out_new_label

    -
    + @@ -381,11 +381,11 @@ ostree_sepolicy_restorecon (

    ostree_sepolicy_setfscreatecon ()

    -
    gboolean
    +
    gboolean
     ostree_sepolicy_setfscreatecon (OstreeSePolicy *self,
                                     const char *path,
    -                                guint32 mode,
    -                                GError **error);
    + guint32 mode, + GError **error);

    Parameters

    New label, or NULL if unchanged.

    New label, or NULL if unchanged.

    [allow-none][out]
    diff --git a/apidoc/html/ostree-Simple-upgrade-class.html b/apidoc/html/ostree-Simple-upgrade-class.html index a74b76da..e9c81950 100644 --- a/apidoc/html/ostree-Simple-upgrade-class.html +++ b/apidoc/html/ostree-Simple-upgrade-class.html @@ -3,7 +3,7 @@ Simple upgrade class: OSTree API references - + @@ -65,7 +65,7 @@
    -GKeyFile * +GKeyFile * ostree_sysroot_upgrader_get_origin () @@ -73,7 +73,7 @@
    -GKeyFile * +GKeyFile * ostree_sysroot_upgrader_dup_origin () @@ -81,7 +81,7 @@
    -gboolean +gboolean ostree_sysroot_upgrader_set_origin () @@ -97,7 +97,7 @@
    -gboolean +gboolean ostree_sysroot_upgrader_check_timestamps () @@ -105,7 +105,7 @@
    -gboolean +gboolean ostree_sysroot_upgrader_pull () @@ -113,7 +113,7 @@
    -gboolean +gboolean ostree_sysroot_upgrader_pull_one_dir () @@ -121,7 +121,7 @@
    -gboolean +gboolean ostree_sysroot_upgrader_deploy () @@ -164,8 +164,8 @@ operations.

    ostree_sysroot_upgrader_new ()

    OstreeSysrootUpgrader *
     ostree_sysroot_upgrader_new (OstreeSysroot *sysroot,
    -                             GCancellable *cancellable,
    -                             GError **error);
    + GCancellable *cancellable, + GError **error);

    Parameters

    @@ -205,8 +205,8 @@ ostree_sysroot_upgrader_new (OstreeSysrootUpgrader * ostree_sysroot_upgrader_new_for_os (OstreeSysroot *sysroot, const char *osname, - GCancellable *cancellable, - GError **error); + GCancellable *cancellable, + GError **error);

    Parameters

    @@ -253,8 +253,8 @@ ostree_sysroot_upgrader_new_for_os_with_flags (OstreeSysroot *sysroot, const char *osname, OstreeSysrootUpgraderFlags flags, - GCancellable *cancellable, - GError **error); + GCancellable *cancellable, + GError **error);

    Parameters

    @@ -301,7 +301,7 @@ ostree_sysroot_upgrader_new_for_os_with_flags

    ostree_sysroot_upgrader_get_origin ()

    -
    GKeyFile *
    +
    GKeyFile *
     ostree_sysroot_upgrader_get_origin (OstreeSysrootUpgrader *self);

    Parameters

    @@ -320,14 +320,14 @@ ostree_sysroot_upgrader_get_origin (

    Returns

    -

    The origin file, or NULL if unknown.

    +

    The origin file, or NULL if unknown.

    [transfer none]


    ostree_sysroot_upgrader_dup_origin ()

    -
    GKeyFile *
    +
    GKeyFile *
     ostree_sysroot_upgrader_dup_origin (OstreeSysrootUpgrader *self);

    Parameters

    @@ -346,18 +346,18 @@ ostree_sysroot_upgrader_dup_origin (

    Returns

    -

    A copy of the origin file, or NULL if unknown.

    +

    A copy of the origin file, or NULL if unknown.

    [transfer full]


    ostree_sysroot_upgrader_set_origin ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_upgrader_set_origin (OstreeSysrootUpgrader *self,
    -                                    GKeyFile *origin,
    -                                    GCancellable *cancellable,
    -                                    GError **error);
    + GKeyFile *origin, + GCancellable *cancellable, + GError **error);

    Replace the origin with origin .

    @@ -416,18 +416,18 @@ ostree_sysroot_upgrader_get_origin_description

    Returns

    -

    A one-line descriptive summary of the origin, or NULL if unknown

    +

    A one-line descriptive summary of the origin, or NULL if unknown


    ostree_sysroot_upgrader_check_timestamps ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_upgrader_check_timestamps
                                    (OstreeRepo *repo,
                                     const char *from_rev,
                                     const char *to_rev,
    -                                GError **error);
    + GError **error);

    Check that the timestamp on to_rev is equal to or newer than from_rev @@ -469,21 +469,21 @@ attackers which provide a client with an older commit.


    ostree_sysroot_upgrader_pull ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_upgrader_pull (OstreeSysrootUpgrader *self,
                                   OstreeRepoPullFlags flags,
                                   OstreeSysrootUpgraderPullFlags upgrader_flags,
                                   OstreeAsyncProgress *progress,
    -                              gboolean *out_changed,
    -                              GCancellable *cancellable,
    -                              GError **error);
    + gboolean *out_changed, + GCancellable *cancellable, + GError **error);

    Perform a pull from the origin. First check if the ref has changed, if so download the linked objects, and store the updated ref locally. Then out_changed - will be TRUE.

    + will be TRUE.

    If the origin remote is unchanged, out_changed will be set to -FALSE.

    +FALSE.

    Parameters

    @@ -535,15 +535,15 @@ ref locally. Then out_changed

    ostree_sysroot_upgrader_pull_one_dir ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_upgrader_pull_one_dir (OstreeSysrootUpgrader *self,
                                           const char *dir_to_pull,
                                           OstreeRepoPullFlags flags,
                                           OstreeSysrootUpgraderPullFlags upgrader_flags,
                                           OstreeAsyncProgress *progress,
    -                                      gboolean *out_changed,
    -                                      GCancellable *cancellable,
    -                                      GError **error);
    + gboolean *out_changed, + GCancellable *cancellable, + GError **error);

    Like ostree_sysroot_upgrader_pull(), but allows retrieving just a subpath of the tree. This can be used to download metadata files from inside the tree such as package databases.

    @@ -603,10 +603,10 @@ from inside the tree such as package databases.


    ostree_sysroot_upgrader_deploy ()

    -
    gboolean
    +
    gboolean
     ostree_sysroot_upgrader_deploy (OstreeSysrootUpgrader *self,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GCancellable *cancellable, + GError **error);

    Write the new deployment to disk, perform a configuration merge with /etc, and update the bootloader configuration.

    diff --git a/apidoc/html/ostree-ostree-bootconfig-parser.html b/apidoc/html/ostree-ostree-bootconfig-parser.html index 1dd343a3..5ec53121 100644 --- a/apidoc/html/ostree-ostree-bootconfig-parser.html +++ b/apidoc/html/ostree-ostree-bootconfig-parser.html @@ -3,7 +3,7 @@ ostree-bootconfig-parser: OSTree API references - + @@ -57,7 +57,7 @@
    -gboolean +gboolean ostree_bootconfig_parser_parse () @@ -65,7 +65,7 @@
    -gboolean +gboolean ostree_bootconfig_parser_parse_at () @@ -73,7 +73,7 @@
    -gboolean +gboolean ostree_bootconfig_parser_write () @@ -81,7 +81,7 @@
    -gboolean +gboolean ostree_bootconfig_parser_write_at () @@ -158,21 +158,21 @@ ostree_bootconfig_parser_clone (

    ostree_bootconfig_parser_parse ()

    -
    gboolean
    +
    gboolean
     ostree_bootconfig_parser_parse (OstreeBootconfigParser *self,
    -                                GFile *path,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GFile *path, + GCancellable *cancellable, + GError **error);

    ostree_bootconfig_parser_parse_at ()

    -
    gboolean
    +
    gboolean
     ostree_bootconfig_parser_parse_at (OstreeBootconfigParser *self,
                                        int dfd,
                                        const char *path,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + GCancellable *cancellable, + GError **error);

    Initialize a bootconfig from the given file.

    Parameters

    @@ -215,21 +215,21 @@ ostree_bootconfig_parser_parse_at (

    ostree_bootconfig_parser_write ()

    -
    gboolean
    +
    gboolean
     ostree_bootconfig_parser_write (OstreeBootconfigParser *self,
    -                                GFile *output,
    -                                GCancellable *cancellable,
    -                                GError **error);
    + GFile *output, + GCancellable *cancellable, + GError **error);

    ostree_bootconfig_parser_write_at ()

    -
    gboolean
    +
    gboolean
     ostree_bootconfig_parser_write_at (OstreeBootconfigParser *self,
                                        int dfd,
                                        const char *path,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + GCancellable *cancellable, + GError **error);

    diff --git a/apidoc/html/ostree-ostree-chain-input-stream.html b/apidoc/html/ostree-ostree-chain-input-stream.html index ac3cfafa..48d5483e 100644 --- a/apidoc/html/ostree-ostree-chain-input-stream.html +++ b/apidoc/html/ostree-ostree-chain-input-stream.html @@ -3,7 +3,7 @@ ostree-chain-input-stream: OSTree API references - + @@ -69,7 +69,7 @@

    ostree_chain_input_stream_new ()

    OstreeChainInputStream *
    -ostree_chain_input_stream_new (GPtrArray *streams);
    +ostree_chain_input_stream_new (GPtrArray *streams);
    diff --git a/apidoc/html/ostree-ostree-checksum-input-stream.html b/apidoc/html/ostree-ostree-checksum-input-stream.html index 9f9a0234..410e5323 100644 --- a/apidoc/html/ostree-ostree-checksum-input-stream.html +++ b/apidoc/html/ostree-ostree-checksum-input-stream.html @@ -3,7 +3,7 @@ ostree-checksum-input-stream: OSTree API references - + @@ -69,8 +69,8 @@

    ostree_checksum_input_stream_new ()

    OstreeChecksumInputStream *
    -ostree_checksum_input_stream_new (GInputStream *stream,
    -                                  GChecksum *checksum);
    +ostree_checksum_input_stream_new (GInputStream *stream, + GChecksum *checksum);
    diff --git a/apidoc/html/ostree-ostree-deployment.html b/apidoc/html/ostree-ostree-deployment.html index f38aa697..e20f55dd 100644 --- a/apidoc/html/ostree-ostree-deployment.html +++ b/apidoc/html/ostree-ostree-deployment.html @@ -3,7 +3,7 @@ ostree-deployment: OSTree API references - + @@ -41,7 +41,7 @@
    -guint +guint ostree_deployment_hash () @@ -49,7 +49,7 @@
    -gboolean +gboolean ostree_deployment_equal () @@ -118,7 +118,7 @@
    -GKeyFile * +GKeyFile * ostree_deployment_get_origin () @@ -142,7 +142,7 @@
    -gboolean +gboolean ostree_deployment_is_pinned () @@ -150,7 +150,7 @@
    -gboolean +gboolean ostree_deployment_is_staged () @@ -234,15 +234,15 @@

    Functions

    ostree_deployment_hash ()

    -
    guint
    -ostree_deployment_hash (gconstpointer v);
    +
    guint
    +ostree_deployment_hash (gconstpointer v);

    ostree_deployment_equal ()

    -
    gboolean
    -ostree_deployment_equal (gconstpointer ap,
    -                         gconstpointer bp);
    +
    gboolean
    +ostree_deployment_equal (gconstpointer ap,
    +                         gconstpointer bp);

    Parameters

    @@ -267,7 +267,7 @@ ostree_deployment_equal (

    Returns

    -

    TRUE if deployments have the same osname, csum, and deployserial

    +

    TRUE if deployments have the same osname, csum, and deployserial


    @@ -346,7 +346,7 @@ ostree_deployment_get_bootconfig (

    ostree_deployment_get_origin ()

    -
    GKeyFile *
    +
    GKeyFile *
     ostree_deployment_get_origin (OstreeDeployment *self);

    Parameters

    @@ -407,7 +407,7 @@ ostree_deployment_get_unlocked (

    ostree_deployment_is_pinned ()

    -
    gboolean
    +
    gboolean
     ostree_deployment_is_pinned (OstreeDeployment *self);

    See ostree_sysroot_deployment_set_pinned().

    @@ -434,7 +434,7 @@ ostree_deployment_is_pinned (

    ostree_deployment_is_staged ()

    -
    gboolean
    +
    gboolean
     ostree_deployment_is_staged (OstreeDeployment *self);

    Parameters

    @@ -483,14 +483,14 @@ ostree_deployment_set_bootconfig (

    ostree_deployment_set_origin ()

    void
     ostree_deployment_set_origin (OstreeDeployment *self,
    -                              GKeyFile *origin);
    + GKeyFile *origin);

    ostree_deployment_origin_remove_transient_state ()

    void
     ostree_deployment_origin_remove_transient_state
    -                               (GKeyFile *origin);
    + (GKeyFile *origin);

    The intention of an origin file is primarily describe the "inputs" that resulted in a deployment, and it's commonly used to derive the new state. For example, a key value (in pure libostree mode) is the "refspec". However, @@ -619,7 +619,7 @@ ostree_deployment_unlocked_state_to_string

    - + @@ -629,7 +629,7 @@ ostree_deployment_unlocked_state_to_string - + diff --git a/apidoc/html/ostree-ostree-diff.html b/apidoc/html/ostree-ostree-diff.html index 9ef6d4bb..73cb7b69 100644 --- a/apidoc/html/ostree-ostree-diff.html +++ b/apidoc/html/ostree-ostree-diff.html @@ -3,7 +3,7 @@ ostree-diff: OSTree API references - + @@ -57,7 +57,7 @@ - + @@ -192,16 +192,16 @@ sets of

    ostree_diff_dirs_with_options ()

    -
    gboolean
    +
    gboolean
     ostree_diff_dirs_with_options (OstreeDiffFlags flags,
    -                               GFile *a,
    -                               GFile *b,
    -                               GPtrArray *modified,
    -                               GPtrArray *removed,
    -                               GPtrArray *added,
    +                               GFile *a,
    +                               GFile *b,
    +                               GPtrArray *modified,
    +                               GPtrArray *removed,
    +                               GPtrArray *added,
                                    OstreeDiffDirsOptions *options,
    -                               GCancellable *cancellable,
    -                               GError **error);
    + GCancellable *cancellable, + GError **error);

    Compute the difference between directory a and b as 3 separate @@ -225,7 +225,7 @@ sets of

    a

    -
    + @@ -271,11 +271,11 @@ sets of

    ostree_diff_print ()

    void
    -ostree_diff_print (GFile *a,
    -                   GFile *b,
    -                   GPtrArray *modified,
    -                   GPtrArray *removed,
    -                   GPtrArray *added);
    +ostree_diff_print (GFile *a, + GFile *b, + GPtrArray *modified, + GPtrArray *removed, + GPtrArray *added);

    Print the contents of a diff to stdout.

    Parameters

    diff --git a/apidoc/html/ostree-ostree-repo-file.html b/apidoc/html/ostree-ostree-repo-file.html index 7f65db64..72b530fe 100644 --- a/apidoc/html/ostree-ostree-repo-file.html +++ b/apidoc/html/ostree-ostree-repo-file.html @@ -3,7 +3,7 @@ ostree-repo-file: OSTree API references - + @@ -40,7 +40,7 @@
     

    GKeyFile *origin;

    GKeyFile *origin;

    How to construct an upgraded version of this tree

     
     

    gboolean staged;

    gboolean staged;

    TRUE iff this deployment is staged

     
    -gboolean +gboolean ostree_diff_dirs () @@ -65,7 +65,7 @@
    -gboolean +gboolean ostree_diff_dirs_with_options () @@ -120,15 +120,15 @@ ostree_diff_item_unref (

    ostree_diff_dirs ()

    -
    gboolean
    +
    gboolean
     ostree_diff_dirs (OstreeDiffFlags flags,
    -                  GFile *a,
    -                  GFile *b,
    -                  GPtrArray *modified,
    -                  GPtrArray *removed,
    -                  GPtrArray *added,
    -                  GCancellable *cancellable,
    -                  GError **error);
    + GFile *a, + GFile *b, + GPtrArray *modified, + GPtrArray *removed, + GPtrArray *added, + GCancellable *cancellable, + GError **error);

    Compute the difference between directory a and b as 3 separate @@ -152,7 +152,7 @@ sets of

    a

    First directory path, or NULL

    First directory path, or NULL

     

    First directory path, or NULL

    First directory path, or NULL

     
    -gboolean +gboolean ostree_repo_file_ensure_resolved () @@ -48,7 +48,7 @@
    -gboolean +gboolean ostree_repo_file_get_xattrs () @@ -94,7 +94,7 @@
    -GVariant * +GVariant * ostree_repo_file_tree_get_contents () @@ -102,7 +102,7 @@
    -GVariant * +GVariant * ostree_repo_file_tree_get_metadata () @@ -125,7 +125,7 @@
    -gboolean +gboolean ostree_repo_file_tree_query_child () @@ -154,18 +154,18 @@

    Functions

    ostree_repo_file_ensure_resolved ()

    -
    gboolean
    +
    gboolean
     ostree_repo_file_ensure_resolved (OstreeRepoFile *self,
    -                                  GError **error);
    + GError **error);

    ostree_repo_file_get_xattrs ()

    -
    gboolean
    +
    gboolean
     ostree_repo_file_get_xattrs (OstreeRepoFile *self,
    -                             GVariant **out_xattrs,
    -                             GCancellable *cancellable,
    -                             GError **error);
    + GVariant **out_xattrs, + GCancellable *cancellable, + GError **error);

    @@ -195,7 +195,7 @@ ostree_repo_file_get_root (void ostree_repo_file_tree_set_metadata (OstreeRepoFile *self, const char *checksum, - GVariant *metadata); + GVariant *metadata);

    @@ -214,13 +214,13 @@ ostree_repo_file_tree_get_metadata_checksum

    ostree_repo_file_tree_get_contents ()

    -
    GVariant *
    +
    GVariant *
     ostree_repo_file_tree_get_contents (OstreeRepoFile *self);

    ostree_repo_file_tree_get_metadata ()

    -
    GVariant *
    +
    GVariant *
     ostree_repo_file_tree_get_metadata (OstreeRepoFile *self);

    @@ -235,20 +235,20 @@ ostree_repo_file_get_checksum (int ostree_repo_file_tree_find_child (OstreeRepoFile *self, const char *name, - gboolean *is_dir, - GVariant **out_container); + gboolean *is_dir, + GVariant **out_container);

    ostree_repo_file_tree_query_child ()

    -
    gboolean
    +
    gboolean
     ostree_repo_file_tree_query_child (OstreeRepoFile *self,
                                        int n,
                                        const char *attributes,
    -                                   GFileQueryInfoFlags flags,
    -                                   GFileInfo **out_info,
    -                                   GCancellable *cancellable,
    -                                   GError **error);
    + GFileQueryInfoFlags flags, + GFileInfo **out_info, + GCancellable *cancellable, + GError **error);
    diff --git a/apidoc/html/reference.html b/apidoc/html/reference.html index 9cb0c176..4e1b3720 100644 --- a/apidoc/html/reference.html +++ b/apidoc/html/reference.html @@ -3,7 +3,7 @@ API Reference: OSTree API references - + @@ -254,6 +254,10 @@
    +OSTREE_CHECK_VERSION, macro in ostree-version +
    +
    +
    ostree_check_version, function in Core repository-independent functions
    @@ -642,6 +646,10 @@ ostree_collection_ref_new, function in ostree-ref
    +OSTREE_RELEASE_VERSION, macro in ostree-version +
    +
    +
    OstreeRemote, struct in ostree-remote
    @@ -1772,6 +1780,23 @@ ostree_validate_collection_id, function in ostree-misc-experimental ostree_validate_structureof_objtype, function in Core repository-independent functions
    +
    +OSTREE_VERSION, macro in ostree-version +
    +
    +
    +OSTREE_VERSION_HEX, macro in ostree-version +
    +
    +
    +OSTREE_VERSION_S, macro in ostree-version +
    +
    +

    Y

    +
    +OSTREE_YEAR_VERSION, macro in ostree-version +
    +