OSTree API references: OSTree API references

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 .

@@ -6731,7 +6731,7 @@

Returns

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

@@ -6739,11 +6739,11 @@

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.

@@ -6791,7 +6791,7 @@

Returns

an OstreeGpgVerifyResult, or NULL on error.

@@ -6800,10 +6800,10 @@

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 @@ -6848,7 +6848,7 @@

Returns

an OstreeGpgVerifyResult, or NULL on error.

@@ -6858,10 +6858,10 @@

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 @@ -6888,12 +6888,12 @@

- + - + @@ -6911,18 +6911,18 @@

Returns

an OstreeGpgVerifyResult, or NULL on error.

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 @@ -6953,7 +6953,7 @@

- + @@ -7097,52 +7097,52 @@ - + - + - + - + - + - + - + - + - + @@ -7415,7 +7415,7 @@

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 -Nru ostree-2017.8/apidoc/html/ostree-Core-repository-independent-functions.html ostree-2017.9/apidoc/html/ostree-Core-repository-independent-functions.html --- ostree-2017.8/apidoc/html/ostree-Core-repository-independent-functions.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-Core-repository-independent-functions.html 2017-07-27 13:12:13.000000000 +0000 @@ -3,7 +3,7 @@ Core repository-independent functions: OSTree API references - + @@ -46,7 +46,7 @@ - - - - + @@ -800,7 +800,7 @@

ostree_checksum_b64_from_bytes ()

char *
-ostree_checksum_b64_from_bytes (const guchar *csum);

+ostree_checksum_b64_from_bytes (const guchar *csum);

Parameters

from

ASCII SHA256 checksum of origin, or NULL

skip_validation

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.

refs_to_fetch

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.

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

homedir

GPG home directory, or NULL.

cancellable

A GCancellable

error

cancellable

A GCancellable

error

homedir

GPG home directory, or NULL.

cancellable

A GCancellable

error

data

Data as a GBytes

signatures

Signatures as a GBytes

summary

Summary data as a GBytes

signatures

Summary signatures as a GBytes

additional_metadata

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

guint metadata_objects_total;

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

guint metadata_objects_written;

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

guint content_objects_total;

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

guint content_objects_written;

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

guint64 content_bytes_written;

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

guint64 padding1;

reserved

guint64 padding2;

reserved

guint64 padding3;

reserved

guint64 padding4;

reserved

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_checksum_file_from_input () @@ -299,7 +299,7 @@

-gboolean +gboolean ostree_checksum_file () @@ -315,7 +315,7 @@

-gboolean +gboolean ostree_checksum_file_async_finish () @@ -323,7 +323,7 @@

-GVariant * +GVariant * ostree_create_directory_metadata () @@ -331,7 +331,7 @@

-gboolean +gboolean ostree_validate_structureof_objtype () @@ -339,7 +339,7 @@

-gboolean +gboolean ostree_validate_structureof_csum_v () @@ -347,7 +347,7 @@

-gboolean +gboolean ostree_validate_structureof_checksum_string () @@ -355,7 +355,7 @@

-gboolean +gboolean ostree_validate_structureof_file_mode () @@ -363,7 +363,7 @@

-gboolean +gboolean ostree_validate_structureof_commit () @@ -371,7 +371,7 @@

-gboolean +gboolean ostree_validate_structureof_dirtree () @@ -379,7 +379,7 @@

-gboolean +gboolean ostree_validate_structureof_dirmeta () @@ -387,7 +387,7 @@

-gchar * +gchar * ostree_commit_get_parent () @@ -395,7 +395,7 @@

-guint64 +guint64 ostree_commit_get_timestamp () @@ -403,7 +403,7 @@

-gboolean +gboolean

ostree_check_version () @@ -483,11 +483,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.

@@ -516,21 +516,21 @@

Returns

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

@@ -556,14 +556,14 @@

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
@@ -583,14 +583,14 @@
 
 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
@@ -609,7 +609,7 @@
 
 
 Returns
- New GVariant of type ay with length 32. 
+ New GVariant of type ay with length 32. 
 [transfer full]
 
 
@@ -617,7 +617,7 @@
 
 ostree_checksum_from_bytes ()
 char *
-ostree_checksum_from_bytes (const guchar *csum);
+ostree_checksum_from_bytes (const guchar *csum);

Parameters

@@ -644,7 +644,7 @@

ostree_checksum_from_bytes_v ()

char *
-ostree_checksum_from_bytes_v (GVariant *csum_v);

+ostree_checksum_from_bytes_v (GVariant *csum_v);

Parameters

@@ -655,7 +655,7 @@ - +

csum_v

GVariant of type ay

@@ -671,7 +671,7 @@

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 @@ -705,7 +705,7 @@

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.

@@ -735,8 +735,8 @@

ostree_checksum_bytes_peek ()

const guchar *
-ostree_checksum_bytes_peek (GVariant *bytes);

const guchar *
+ostree_checksum_bytes_peek (GVariant *bytes);

Parameters

@@ -747,7 +747,7 @@ - +

bytes

GVariant of type ay

@@ -756,16 +756,16 @@

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 .

@@ -779,7 +779,7 @@

bytes

GVariant of type ay

@@ -828,7 +828,7 @@

ostree_checksum_b64_to_bytes ()

guchar *
+guchar *
 ostree_checksum_b64_to_bytes (const char *checksum);
 
 Parameters
@@ -857,7 +857,7 @@
 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
@@ -893,7 +893,7 @@
 
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 .

@@ -925,8 +925,8 @@

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

@@ -954,9 +954,9 @@

ostree_validate_rev ()

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

Parameters

@@ -981,16 +981,16 @@

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

@@ -1015,7 +1015,7 @@

Returns

TRUE if remote_name +

TRUE if remote_name is a valid remote name

Since: 2017.8

@@ -1023,11 +1023,11 @@

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" into two parts; out_remote will be set to "gnome-ostree", and out_ref @@ -1035,7 +1035,7 @@ will be "gnome-ostree/buildmaster".

If refspec refers to a local ref, out_remote - will be NULL.

+ will be NULL.

Parameters

@@ -1052,7 +1052,7 @@ - + @@ -1117,9 +1117,9 @@

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

The remote name, or NULL if the refspec refs to a local ref.

[out][allow-none]

@@ -1130,7 +1130,7 @@ - +

A GVariant containing a serialized object

@@ -1139,7 +1139,7 @@

ostree_object_name_serialize ()

GVariant *
+GVariant *
 ostree_object_name_serialize (const char *checksum,
                               OstreeObjectType objtype);
 
@@ -1166,7 +1166,7 @@
 
 
 Returns
- A new floating GVariant containing checksum string and objtype. 
+ A new floating GVariant containing checksum string and objtype. 
 [transfer floating]

@@ -1174,7 +1174,7 @@

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 @@ -1192,7 +1192,7 @@

variant

A GVariant of type (su)

@@ -1250,7 +1250,7 @@

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().

@@ -1284,16 +1284,16 @@

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.

@@ -1322,7 +1322,7 @@

trusted

If TRUE, assume the content has been validated

@@ -1357,15 +1357,15 @@

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.

@@ -1389,7 +1389,7 @@

trusted

If TRUE, assume the content has been validated

@@ -1424,16 +1424,16 @@

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.

@@ -1462,7 +1462,7 @@

trusted

If TRUE, assume the content has been validated

@@ -1497,13 +1497,13 @@

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.

@@ -1552,15 +1552,15 @@

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 @@ -1617,14 +1617,14 @@

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.

@@ -1679,14 +1679,14 @@

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

@@ -1709,7 +1709,7 @@

File content, should be NULL for symbolic links.

[allow-none] @@ -1739,12 +1739,12 @@

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

@@ -1788,12 +1788,12 @@

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().

@@ -1843,11 +1843,11 @@

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().

@@ -1886,9 +1886,9 @@

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

@@ -1900,7 +1900,7 @@ - + @@ -1913,16 +1913,16 @@

Returns

A new GVariant containing OSTREE_OBJECT_TYPE_DIR_META.

ostree_validate_structureof_objtype ()

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

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

Parameters

dir_info

a GFileInfo containing directory information

@@ -1940,16 +1940,16 @@

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

@@ -1961,7 +1961,7 @@ - + @@ -1974,17 +1974,17 @@

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

checksum

a GVariant of type "ay"

@@ -2009,16 +2009,16 @@

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

@@ -2043,16 +2043,16 @@

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.

@@ -2080,16 +2080,16 @@

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.

@@ -2117,16 +2117,16 @@

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 .

@@ -2153,15 +2153,15 @@

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

@@ -2180,22 +2180,22 @@

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_check_version ()

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

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

Parameters

@@ -2220,7 +2220,7 @@

Returns

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

diff -Nru ostree-2017.8/apidoc/html/ostree-GPG-signature-verification-results.html ostree-2017.9/apidoc/html/ostree-GPG-signature-verification-results.html --- ostree-2017.8/apidoc/html/ostree-GPG-signature-verification-results.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-GPG-signature-verification-results.html 2017-07-27 13:12:13.000000000 +0000 @@ -3,7 +3,7 @@ GPG signature verification results: OSTree API references - + @@ -41,7 +41,7 @@ +, or NULL.

@@ -244,22 +244,22 @@

Returns

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 @@ -300,29 +300,29 @@

Returns

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.

@@ -355,7 +355,7 @@

Returns

a new, floating, GVariant tuple

@@ -363,9 +363,9 @@

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 @@ -404,7 +404,7 @@

- + @@ -426,11 +426,11 @@

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 @@ -447,12 +447,12 @@

- + - + @@ -472,14 +472,14 @@

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.

@@ -498,7 +498,7 @@

- + @@ -506,9 +506,9 @@

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

@@ -524,7 +524,7 @@

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 () @@ -146,7 +146,7 @@ Functions ostree_gpg_verify_result_count_all () - guint + guint ostree_gpg_verify_result_count_all (`OstreeGpgVerifyResult result`); Counts all the signatures in `result`* . @@ -173,7 +173,7 @@ ostree_gpg_verify_result_count_valid () - guint + guint ostree_gpg_verify_result_count_valid (`OstreeGpgVerifyResult result`); Counts only the valid signatures in `result`* . @@ -200,17 +200,17 @@ 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. @@ -236,7 +236,7 @@	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
error	A GError	A GError

@@ -537,56 +537,56 @@ @@ -594,7 +594,7 @@ @@ -602,7 +602,7 @@ @@ -610,14 +610,14 @@ diff -Nru ostree-2017.8/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html ostree-2017.9/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html --- ostree-2017.8/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-In-memory-modifiable-filesystem-tree.html 2017-07-27 13:12:13.000000000 +0000 @@ -3,7 +3,7 @@ In-memory modifiable filesystem tree: OSTree API references - + @@ -79,7 +79,7 @@ - + @@ -281,12 +281,12 @@

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 @@

ostree_mutable_tree_get_subdirs ()

GHashTable *
+GHashTable *
 ostree_mutable_tree_get_subdirs (OstreeMutableTree *self);
 
 Returns
@@ -345,7 +345,7 @@
 
 
 ostree_mutable_tree_get_files ()
-GHashTable *
+GHashTable *
 ostree_mutable_tree_get_files (OstreeMutableTree *self);
 
 Returns
diff -Nru ostree-2017.8/apidoc/html/ostree-ostree-bootconfig-parser.html ostree-2017.9/apidoc/html/ostree-ostree-bootconfig-parser.html
--- ostree-2017.8/apidoc/html/ostree-ostree-bootconfig-parser.html	2017-07-06 19:03:27.000000000 +0000
+++ ostree-2017.9/apidoc/html/ostree-ostree-bootconfig-parser.html	2017-07-27 13:12:13.000000000 +0000
@@ -3,7 +3,7 @@
 
 
 ostree-bootconfig-parser: OSTree API references
-
+
 
 
 
@@ -57,7 +57,7 @@

- + @@ -299,10 +299,10 @@

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 @@
 
 Returns
  value for the given key
-, or NULL if
+, or NULL if
 it was not set. 
 [transfer full][nullable]
 
@@ -338,14 +338,14 @@
 
 
 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_set_status (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 @@

- + @@ -389,11 +389,11 @@ ostree_async_progress_set (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.

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

OSTREE_GPG_SIGNATURE_ATTR_VALID

[G_VARIANT_TYPE_BOOLEAN] Is the signature valid?

OSTREE_GPG_SIGNATURE_ATTR_SIG_EXPIRED

[G_VARIANT_TYPE_BOOLEAN] Has the signature expired?

OSTREE_GPG_SIGNATURE_ATTR_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?

OSTREE_GPG_SIGNATURE_ATTR_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

OSTREE_GPG_SIGNATURE_ATTR_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)

OSTREE_GPG_SIGNATURE_ATTR_PUBKEY_ALGO_NAME

[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

OSTREE_GPG_SIGNATURE_ATTR_HASH_ALGO_NAME

[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

OSTREE_GPG_SIGNATURE_ATTR_USER_NAME

[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

-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_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 @@

error

-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_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_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 -Nru ostree-2017.8/apidoc/html/ostree-ostree-chain-input-stream.html ostree-2017.9/apidoc/html/ostree-ostree-chain-input-stream.html --- ostree-2017.8/apidoc/html/ostree-ostree-chain-input-stream.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-ostree-chain-input-stream.html 2017-07-27 13:12:13.000000000 +0000 @@ -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 -Nru ostree-2017.8/apidoc/html/ostree-ostree-checksum-input-stream.html ostree-2017.9/apidoc/html/ostree-ostree-checksum-input-stream.html --- ostree-2017.8/apidoc/html/ostree-ostree-checksum-input-stream.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-ostree-checksum-input-stream.html 2017-07-27 13:12:13.000000000 +0000 @@ -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 -Nru ostree-2017.8/apidoc/html/ostree-ostree-deployment.html ostree-2017.9/apidoc/html/ostree-ostree-deployment.html --- ostree-2017.8/apidoc/html/ostree-ostree-deployment.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-ostree-deployment.html 2017-07-27 13:12:13.000000000 +0000 @@ -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 () @@ -210,15 +210,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

@@ -243,7 +243,7 @@

Returns

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

@@ -322,7 +322,7 @@

ostree_deployment_get_origin ()

GKeyFile *
+GKeyFile *
 ostree_deployment_get_origin (OstreeDeployment *self);
 
 Parameters
@@ -406,7 +406,7 @@
 ostree_deployment_set_origin ()
 void
 ostree_deployment_set_origin (OstreeDeployment *self,
-                              GKeyFile *origin);
+                              GKeyFile *origin);

@@ -506,7 +506,7 @@

- + diff -Nru ostree-2017.8/apidoc/html/ostree-ostree-diff.html ostree-2017.9/apidoc/html/ostree-ostree-diff.html --- ostree-2017.8/apidoc/html/ostree-ostree-diff.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-ostree-diff.html 2017-07-27 13:12:13.000000000 +0000 @@ -3,7 +3,7 @@ ostree-diff: OSTree API references - + @@ -57,7 +57,7 @@ - + @@ -192,16 +192,16 @@

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 @@

- + @@ -271,11 +271,11 @@

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 -Nru ostree-2017.8/apidoc/html/ostree-ostree-repo-file.html ostree-2017.9/apidoc/html/ostree-ostree-repo-file.html --- ostree-2017.8/apidoc/html/ostree-ostree-repo-file.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-ostree-repo-file.html 2017-07-27 13:12:13.000000000 +0000 @@ -3,7 +3,7 @@ ostree-repo-file: OSTree API references - + @@ -40,7 +40,7 @@

+ NULL);


GKeyFile *`origin`;	GKeyFile *`origin`;	How to construct an upgraded version of this tree
-gboolean +gboolean	ostree_diff_dirs () @@ -65,7 +65,7 @@
-gboolean +gboolean	ostree_diff_dirs_with_options () @@ -120,15 +120,15 @@ 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 @@
a	First directory path, or `NULL`	First directory path, or `NULL`
a	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 @@ 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_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 @@ 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 -Nru ostree-2017.8/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html ostree-2017.9/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html --- ostree-2017.8/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-Progress-notification-system-for-asynchronous-operations.html 2017-07-27 13:12:13.000000000 +0000 @@ -3,7 +3,7 @@ Progress notification system for asynchronous operations: OSTree API references - + @@ -73,7 +73,7 @@
-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 @@ 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_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 @@ 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 @@ 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 @@ `...`*); 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. @@ -257,15 +257,15 @@ 11	guint32 outstanding_fetches; guint64 bytes_received; -g_autofree gchar status = NULL; -g_autoptr(GVariant) refs_variant = NULL; +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 @@

...

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

status

new status string, or NULL to clear the status.

[nullable]

@@ -440,7 +440,7 @@

...

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

@@ -454,13 +454,13 @@

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 @@

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

+ guint value);

@@ -509,7 +509,7 @@

void
 ostree_async_progress_set_uint64 (OstreeAsyncProgress *self,
                                   const char *key,
-                                  guint64 value);

+ guint64 value);

diff -Nru ostree-2017.8/apidoc/html/ostree-Root-partition-mount-point.html ostree-2017.9/apidoc/html/ostree-Root-partition-mount-point.html --- ostree-2017.8/apidoc/html/ostree-Root-partition-mount-point.html 2017-07-06 19:03:27.000000000 +0000 +++ ostree-2017.9/apidoc/html/ostree-Root-partition-mount-point.html 2017-07-27 13:12:13.000000000 +0000 @@ -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 () @@ -225,7 +225,7 @@ -gboolean +gboolean ostree_sysroot_get_repo () @@ -233,7 +233,7 @@ -gboolean +gboolean ostree_sysroot_init_osname () @@ -241,7 +241,7 @@ -gboolean +gboolean ostree_sysroot_deployment_set_kargs () @@ -249,7 +249,7 @@ -gboolean +gboolean ostree_sysroot_deployment_set_mutable () @@ -257,7 +257,7 @@ -gboolean +gboolean ostree_sysroot_deployment_unlock () @@ -265,7 +265,7 @@ -gboolean +gboolean ostree_sysroot_write_deployments () @@ -273,7 +273,7 @@ -gboolean +gboolean ostree_sysroot_write_deployments_with_options () @@ -281,7 +281,7 @@ -gboolean +gboolean ostree_sysroot_write_origin_file () @@ -289,7 +289,7 @@ -gboolean +gboolean ostree_sysroot_deploy_tree () @@ -313,7 +313,7 @@ -GKeyFile * +GKeyFile * ostree_sysroot_origin_new_from_refspec () @@ -321,7 +321,7 @@ -gboolean +gboolean ostree_sysroot_simple_write_deployment () @@ -364,7 +364,7 @@

ostree_sysroot_new ()

OstreeSysroot *
-ostree_sysroot_new (GFile *path);

+ostree_sysroot_new (GFile *path);

Parameters

@@ -375,7 +375,7 @@ - +

path

Path to a system root directory, or NULL.