diff --git a/rust-bindings/rust/gir-files/OSTree-1.0.gir b/rust-bindings/rust/gir-files/OSTree-1.0.gir index 4517063d..9f11771d 100644 --- a/rust-bindings/rust/gir-files/OSTree-1.0.gir +++ b/rust-bindings/rust/gir-files/OSTree-1.0.gir @@ -551,7 +551,7 @@ Any watchers of the #OstreeAsyncProgress will be notified of the change if + + Structure representing an entry in the "ostree.sizes" commit metadata. Each +entry corresponds to an object in the associated commit. + + + object checksum + + + + object type + + + + unpacked object size + + + + compressed object size + + + + Create a new #OstreeCommitSizesEntry for representing an object in a +commit's "ostree.sizes" metadata. + + + a new #OstreeCommitSizesEntry + + + + + object checksum + + + + object type + + + + unpacked object size + + + + compressed object size + + + + + + Create a copy of the given @entry. + + + a new copy of @entry + + + + + an #OstreeCommitSizesEntry + + + + + + Free given @entry. + + + + + + + an #OstreeCommitSizesEntry + + + + + @@ -1973,7 +2092,7 @@ ostree_diff_dirs_with_options(). filename="ostree-gpg-verify-result.h" line="157">Errors returned by signature creation and verification operations in OSTree. These may be returned by any API which creates or verifies signatures. - + @@ -1995,6 +2114,29 @@ These may be returned by any API which creates or verifies signatures. filename="ostree-gpg-verify-result.h" line="161">A signature was found, but was created with a key not in the configured keyrings. + + A signature was expired. Since: 2020.1. + + + A signature was found, but the key used to + sign it has expired. Since: 2020.1. + + + A signature was found, but the key used to + sign it has been revoked. Since: 2020.1. + c:identifier="ostree_gpg_verify_result_describe_variant"> Similar to ostree_gpg_verify_result_describe() but takes a #GVariant of + line="583">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. @@ -2163,13 +2305,13 @@ ostree_gpg_verify_result_get_all(). a #GVariant from ostree_gpg_verify_result_get_all() + line="585">a #GVariant from ostree_gpg_verify_result_get_all() a #GString to hold the description + line="586">a #GString to hold the description allow-none="1"> optional line prefix string + line="587">optional line prefix string flags to adjust the description format + line="588">flags to adjust the description format @@ -2429,7 +2571,7 @@ If no match is found, the function returns %FALSE and leaves throws="1"> Checks if the result contains at least one signature from the + line="748">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 and filled @error too. @@ -2437,7 +2579,7 @@ it will handle the %NULL @result and filled @error too. %TRUE if @result was not %NULL and had at least one + line="758">%TRUE if @result was not %NULL and had at least one signature from trusted keyring, otherwise %FALSE @@ -2448,7 +2590,7 @@ signature from trusted keyring, otherwise %FALSE allow-none="1"> an #OstreeGpgVerifyResult + line="750">an #OstreeGpgVerifyResult @@ -4005,7 +4147,7 @@ content, the other types are metadata. An accessor object for an OSTree repository located at @path + line="1244">An accessor object for an OSTree repository located at @path Path to a repository + line="1242">Path to a repository @@ -4222,7 +4364,7 @@ reference count reaches 0. If the current working directory appears to be an OSTree + line="1317">If the current working directory appears to be an OSTree repository, create a new #OstreeRepo object for accessing it. Otherwise use the path in the OSTREE_REPO environment variable (if defined) or else the default system repository located at @@ -4231,7 +4373,7 @@ Otherwise use the path in the OSTREE_REPO environment variable An accessor object for an OSTree repository located at /ostree/repo + line="1326">An accessor object for an OSTree repository located at /ostree/repo @@ -4239,26 +4381,26 @@ Otherwise use the path in the OSTREE_REPO environment variable c:identifier="ostree_repo_new_for_sysroot_path"> Creates a new #OstreeRepo instance, taking the system root path explicitly + line="1300">Creates a new #OstreeRepo instance, taking the system root path explicitly instead of assuming "/". An accessor object for the OSTree repository located at @repo_path. + line="1308">An accessor object for the OSTree repository located at @repo_path. Path to a repository + line="1302">Path to a repository Path to the system root + line="1303">Path to the system root @@ -4269,7 +4411,7 @@ instead of assuming "/". throws="1"> This is a file-descriptor relative version of ostree_repo_create(). + line="2604">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. @@ -4285,32 +4427,32 @@ The @options dict may contain: A new OSTree repository reference + line="2626">A new OSTree repository reference Directory fd + line="2606">Directory fd Path + line="2607">Path The mode to store the repository in + line="2608">The mode to store the repository in a{sv}: See below for accepted keys + line="2609">a{sv}: See below for accepted keys Cancellable + line="2610">Cancellable @@ -4335,7 +4477,7 @@ The @options dict may contain: a repo mode as a string + line="2430">a repo mode as a string the corresponding #OstreeRepoMode + line="2431">the corresponding #OstreeRepoMode @@ -4355,27 +4497,27 @@ The @options dict may contain: throws="1"> This combines ostree_repo_new() (but using fd-relative access) with + line="1265">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(). An accessor object for an OSTree repository located at @dfd + @path + line="1274">An accessor object for an OSTree repository located at @dfd + @path Directory fd + line="1267">Directory fd Path + line="1268">Path Convenient "changed" callback for use with + line="4807">Convenient "changed" callback for use with ostree_async_progress_new_and_connect() when pulling from a remote repository. @@ -4410,7 +4552,7 @@ and @user_data is ignored. Async progress + line="4809">Async progress allow-none="1"> User data + line="4810">User data @@ -4494,7 +4636,7 @@ the commits the key belongs to. throws="1"> Abort the active transaction; any staged objects and ref changes will be + line="2425">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 transaction will do nothing and return successfully. @@ -4506,7 +4648,7 @@ transaction will do nothing and return successfully. An #OstreeRepo + line="2427">An #OstreeRepo allow-none="1"> Cancellable + line="2428">Cancellable @@ -4525,7 +4667,7 @@ transaction will do nothing and return successfully. throws="1"> Add a GPG signature to a summary file. + line="5181">Add a GPG signature to a summary file. @@ -4534,13 +4676,13 @@ transaction will do nothing and return successfully. Self + line="5183">Self NULL-terminated array of GPG keys. + line="5184">NULL-terminated array of GPG keys. @@ -4551,7 +4693,7 @@ transaction will do nothing and return successfully. allow-none="1"> GPG home directory, or %NULL + line="5185">GPG home directory, or %NULL allow-none="1"> A #GCancellable + line="5186">A #GCancellable @@ -4570,7 +4712,7 @@ transaction will do nothing and return successfully. throws="1"> Append a GPG signature to a commit. + line="4957">Append a GPG signature to a commit. @@ -4579,19 +4721,19 @@ transaction will do nothing and return successfully. Self + line="4959">Self SHA256 of given commit to sign + line="4960">SHA256 of given commit to sign Signature data + line="4961">Signature data allow-none="1"> A #GCancellable + line="4962">A #GCancellable @@ -4835,7 +4977,7 @@ This function is deprecated. Use ostree_repo_checkout_at() instead. throws="1"> Complete the transaction. Any refs set with + line="2332">Complete the transaction. Any refs set with ostree_repo_transaction_set_ref() or ostree_repo_transaction_set_refspec() will be written out. @@ -4853,7 +4995,7 @@ active at a time. An #OstreeRepo + line="2334">An #OstreeRepo allow-none="1"> A set of statistics of things + line="2335">A set of statistics of things that happened during this transaction. @@ -4875,7 +5017,7 @@ that happened during this transaction. allow-none="1"> Cancellable + line="2337">Cancellable @@ -4885,7 +5027,7 @@ that happened during this transaction. A newly-allocated copy of the repository config + line="1445">A newly-allocated copy of the repository config @@ -4897,7 +5039,7 @@ that happened during this transaction. Create the underlying structure on disk for the repository, and call + line="2556">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 @@ -4919,13 +5061,13 @@ this function on a repository initialized via ostree_repo_open_at(). An #OstreeRepo + line="2558">An #OstreeRepo The mode to store the repository in + line="2559">The mode to store the repository in allow-none="1"> Cancellable + line="2560">Cancellable @@ -4944,7 +5086,7 @@ this function on a repository initialized via ostree_repo_open_at(). throws="1"> Remove the object of type @objtype with checksum @sha256 + line="4252">Remove the object of type @objtype with checksum @sha256 from the repository. An error of type %G_IO_ERROR_NOT_FOUND is thrown if the object does not exist. @@ -4955,19 +5097,19 @@ is thrown if the object does not exist. Repo + line="4254">Repo Object type + line="4255">Object type Checksum + line="4256">Checksum allow-none="1"> Cancellable + line="4257">Cancellable @@ -4984,27 +5126,27 @@ is thrown if the object does not exist. Check whether two opened repositories are the same on disk: if their root + line="3526">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. %TRUE if @a and @b are the same repository on disk, %FALSE otherwise + line="3535">%TRUE if @a and @b are the same repository on disk, %FALSE otherwise an #OstreeRepo + line="3528">an #OstreeRepo an #OstreeRepo + line="3529">an #OstreeRepo @@ -5015,7 +5157,7 @@ ostree_repo_open() not being called on them yet), %FALSE will be returned. throws="1"> Import an archive file @archive into the repository, and write its + line="1223">Import an archive file @archive into the repository, and write its file structure to @mtree. @@ -5025,20 +5167,20 @@ file structure to @mtree. An #OstreeRepo + line="1225">An #OstreeRepo Options controlling conversion + line="1226">Options controlling conversion An #OstreeRepoFile for the base directory + line="1227">An #OstreeRepoFile for the base directory allow-none="1"> A `struct archive`, but specified as void to avoid a dependency on the libarchive headers + line="1228">A `struct archive`, but specified as void to avoid a dependency on the libarchive headers allow-none="1"> Cancellable + line="1229">Cancellable @@ -5224,7 +5366,7 @@ ostree_repo_find_remotes_async(). throws="1"> Verify consistency of the object; this performs checks only relevant to the + line="4368">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. @@ -5235,19 +5377,19 @@ traverse metadata objects for example. Repo + line="4370">Repo Object type + line="4371">Object type Checksum + line="4372">Checksum allow-none="1"> Cancellable + line="4373">Cancellable @@ -5266,20 +5408,20 @@ traverse metadata objects for example. version="2019.2"> Get the bootloader configured. See the documentation for the + line="6266">Get the bootloader configured. See the documentation for the "sysroot.bootloader" config key. bootloader configuration for the sysroot + line="6273">bootloader configuration for the sysroot an #OstreeRepo + line="6268">an #OstreeRepo @@ -5289,19 +5431,19 @@ traverse metadata objects for example. version="2018.6"> Get the collection ID of this repository. See [collection IDs][collection-ids]. + line="6194">Get the collection ID of this repository. See [collection IDs][collection-ids]. collection ID for the repository + line="6200">collection ID for the repository an #OstreeRepo + line="6196">an #OstreeRepo @@ -5311,7 +5453,7 @@ traverse metadata objects for example. The repository configuration; do not modify + line="1431">The repository configuration; do not modify @@ -5325,13 +5467,13 @@ traverse metadata objects for example. version="2018.9"> Get the set of default repo finders configured. See the documentation for + line="6247">Get the set of default repo finders configured. See the documentation for the "core.default-repo-finders" config key. + line="6254"> %NULL-terminated array of strings. @@ -5341,7 +5483,7 @@ the "core.default-repo-finders" config key. an #OstreeRepo + line="6249">an #OstreeRepo @@ -5351,7 +5493,7 @@ the "core.default-repo-finders" config key. version="2016.4"> In some cases it's useful for applications to access the repository + line="3477">In some cases it's useful for applications to access the repository directly; for example, writing content into `repo/tmp` ensures it's on the same filesystem. Another case is detecting the mtime on the repository (to see whether a ref was written). @@ -5359,14 +5501,14 @@ repository (to see whether a ref was written). File descriptor for repository root - owned by @self + line="3486">File descriptor for repository root - owned by @self Repo + line="3479">Repo @@ -5375,19 +5517,19 @@ repository (to see whether a ref was written). c:identifier="ostree_repo_get_disable_fsync"> For more information see ostree_repo_set_disable_fsync(). + line="3424">For more information see ostree_repo_set_disable_fsync(). Whether or not fsync() is enabled for this repo. + line="3430">Whether or not fsync() is enabled for this repo. An #OstreeRepo + line="3426">An #OstreeRepo @@ -5398,7 +5540,7 @@ repository (to see whether a ref was written). throws="1"> Determine the number of bytes of free disk space that are reserved according + line="3559">Determine the number of bytes of free disk space that are reserved according to the repo config and return that number in @out_reserved_bytes. See the documentation for the core.min-free-space-size and core.min-free-space-percent repo config options. @@ -5406,14 +5548,14 @@ core.min-free-space-percent repo config options. %TRUE on success, %FALSE otherwise. + line="3570">%TRUE on success, %FALSE otherwise. Repo + line="3561">Repo transfer-ownership="full"> Location to store the result + line="3562">Location to store the result @@ -5441,20 +5583,20 @@ core.min-free-space-percent repo config options. Before this function can be used, ostree_repo_init() must have been + line="3586">Before this function can be used, ostree_repo_init() must have been called. Parent repository, or %NULL if none + line="3593">Parent repository, or %NULL if none Repo + line="3588">Repo @@ -5462,21 +5604,21 @@ called. Note that since the introduction of ostree_repo_open_at(), this function may + line="3455">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 that API. In general, you should avoid use of this API. Path to repo + line="3463">Path to repo Repo + line="3457">Repo @@ -5487,7 +5629,7 @@ that API. In general, you should avoid use of this API. throws="1"> OSTree remotes are represented by keyfile groups, formatted like: + line="936">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 boolean. If the option is not set, @out_value will be set to @default_value. If an @@ -5496,32 +5638,32 @@ error is returned, @out_value will be set to %FALSE. %TRUE on success, otherwise %FALSE with @error set + line="951">%TRUE on success, otherwise %FALSE with @error set A OstreeRepo + line="938">A OstreeRepo Name + line="939">Name Option + line="940">Option Value returned if @option_name is not present + line="941">Value returned if @option_name is not present transfer-ownership="full"> location to store the result. + line="942">location to store the result. @@ -5541,7 +5683,7 @@ error is returned, @out_value will be set to %FALSE. throws="1"> OSTree remotes are represented by keyfile groups, formatted like: + line="858">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 @@ -5550,26 +5692,26 @@ to %NULL. %TRUE on success, otherwise %FALSE with @error set + line="874">%TRUE on success, otherwise %FALSE with @error set A OstreeRepo + line="860">A OstreeRepo Name + line="861">Name Option + line="862">Option transfer-ownership="full"> location to store the list + line="863">location to store the list of strings. The list should be freed with g_strfreev(). @@ -5593,7 +5735,7 @@ to %NULL. throws="1"> OSTree remotes are represented by keyfile groups, formatted like: + line="780">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. @@ -5601,26 +5743,26 @@ option name. If an error is returned, @out_value will be set to %NULL. %TRUE on success, otherwise %FALSE with @error set + line="794">%TRUE on success, otherwise %FALSE with @error set A OstreeRepo + line="782">A OstreeRepo Name + line="783">Name Option + line="784">Option allow-none="1"> Value returned if @option_name is not present + line="785">Value returned if @option_name is not present transfer-ownership="full"> Return location for value + line="786">Return location for value @@ -5649,7 +5791,7 @@ option name. If an error is returned, @out_value will be set to %NULL. throws="1"> Verify @signatures for @data using GPG keys in the keyring for + line="5603">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 @@ -5658,14 +5800,14 @@ the verifications using GPG keys in the keyrings of all remotes. an #OstreeGpgVerifyResult, or %NULL on error + line="5620">an #OstreeGpgVerifyResult, or %NULL on error Repository + line="5605">Repository allow-none="1"> Name of remote + line="5606">Name of remote Data as a #GBytes + line="5607">Data as a #GBytes Signatures as a #GBytes + line="5608">Signatures as a #GBytes allow-none="1"> Path to directory GPG keyrings; overrides built-in default if given + line="5609">Path to directory GPG keyrings; overrides built-in default if given allow-none="1"> Path to additional keyring file (not a directory) + line="5610">Path to additional keyring file (not a directory) allow-none="1"> Cancellable + line="5611">Cancellable @@ -5723,32 +5865,32 @@ the verifications using GPG keys in the keyrings of all remotes. throws="1"> Set @out_have_object to %TRUE if @self contains the given object; + line="4210">Set @out_have_object to %TRUE if @self contains the given object; %FALSE otherwise. %FALSE if an unexpected error occurred, %TRUE otherwise + line="4222">%FALSE if an unexpected error occurred, %TRUE otherwise Repo + line="4212">Repo Object type + line="4213">Object type ASCII SHA256 checksum + line="4214">ASCII SHA256 checksum transfer-ownership="full"> %TRUE if repository contains object + line="4215">%TRUE if repository contains object allow-none="1"> Cancellable + line="4216">Cancellable @@ -5774,7 +5916,7 @@ the verifications using GPG keys in the keyrings of all remotes. Calculate a hash value for the given open repository, suitable for use when + line="3496">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 which is not yet open, as a persistent hash value cannot be calculated until the repository is open and the inode of its root directory has been loaded. @@ -5784,14 +5926,14 @@ This function does no I/O. hash value for the #OstreeRepo + line="3507">hash value for the #OstreeRepo an #OstreeRepo + line="3498">an #OstreeRepo @@ -5863,7 +6005,7 @@ file structure to @mtree. throws="1"> Copy object named by @objtype and @checksum into @self from the + line="4395">Copy object named by @objtype and @checksum into @self from the source repository @source. If both repositories are of the same type and on the same filesystem, this will simply be a fast Unix hard link operation. @@ -5877,25 +6019,25 @@ Otherwise, a copy will be performed. Destination repo + line="4397">Destination repo Source repo + line="4398">Source repo Object type + line="4399">Object type checksum + line="4400">checksum allow-none="1"> Cancellable + line="4401">Cancellable @@ -5915,7 +6057,7 @@ Otherwise, a copy will be performed. throws="1"> Copy object named by @objtype and @checksum into @self from the + line="4424">Copy object named by @objtype and @checksum into @self from the source repository @source. If @trusted is %TRUE and both repositories are of the same type and on the same filesystem, this will simply be a fast Unix hard link operation. @@ -5929,31 +6071,31 @@ Otherwise, a copy will be performed. Destination repo + line="4426">Destination repo Source repo + line="4427">Source repo Object type + line="4428">Object type checksum + line="4429">checksum If %TRUE, assume the source repo is valid and trusted + line="4430">If %TRUE, assume the source repo is valid and trusted allow-none="1"> Cancellable + line="4431">Cancellable @@ -5972,14 +6114,14 @@ Otherwise, a copy will be performed. %TRUE if this repository is the root-owned system global repository + line="1355">%TRUE if this repository is the root-owned system global repository Repository + line="1353">Repository @@ -5989,20 +6131,20 @@ Otherwise, a copy will be performed. throws="1"> Returns whether the repository is writable by the current user. + line="1385">Returns whether the repository is writable by the current user. If the repository is not writable, the @error indicates why. %TRUE if this repository is writable + line="1393">%TRUE if this repository is writable Repo + line="1387">Repo @@ -6086,26 +6228,26 @@ If you want to exclude refs from `refs/remotes`, use throws="1"> This function synchronously enumerates all commit objects starting + line="4617">This function synchronously enumerates all commit objects starting with @start, returning data in @out_commits. %TRUE on success, %FALSE on error, and @error will be set + line="4629">%TRUE on success, %FALSE on error, and @error will be set Repo + line="4619">Repo List commits starting with this checksum + line="4620">List commits starting with this checksum transfer-ownership="container"> + line="4621"> Map of serialized commit name to variant data @@ -6127,7 +6269,7 @@ Map of serialized commit name to variant data allow-none="1"> Cancellable + line="4623">Cancellable @@ -6137,7 +6279,7 @@ Map of serialized commit name to variant data throws="1"> This function synchronously enumerates all objects in the + line="4563">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. @@ -6145,20 +6287,20 @@ to #GVariant values of type %OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE. %TRUE on success, %FALSE on error, and @error will be set + line="4577">%TRUE on success, %FALSE on error, and @error will be set Repo + line="4565">Repo Flags controlling enumeration + line="4566">Flags controlling enumeration @@ -6168,7 +6310,7 @@ to #GVariant values of type %OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE. transfer-ownership="container"> + line="4567"> Map of serialized object name to variant data @@ -6181,7 +6323,7 @@ Map of serialized object name to variant data allow-none="1"> Cancellable + line="4569">Cancellable @@ -6349,7 +6491,7 @@ repository, returning its result in @out_deltas. throws="1"> A version of ostree_repo_load_variant() specialized to commits, + line="4539">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 means that only a sub-path of the commit is available. @@ -6361,13 +6503,13 @@ means that only a sub-path of the commit is available. Repo + line="4541">Repo Commit checksum + line="4542">Commit checksum allow-none="1"> Commit + line="4543">Commit allow-none="1"> Commit state + line="4544">Commit state @@ -6397,7 +6539,7 @@ means that only a sub-path of the commit is available. Load content object, decomposing it into three parts: the actual + line="4049">Load content object, decomposing it into three parts: the actual content (for regular files), the metadata, and extended attributes. @@ -6407,13 +6549,13 @@ content (for regular files), the metadata, and extended attributes. Repo + line="4051">Repo ASCII SHA256 checksum + line="4052">ASCII SHA256 checksum allow-none="1"> File content + line="4053">File content allow-none="1"> File information + line="4054">File information allow-none="1"> Extended attributes + line="4055">Extended attributes allow-none="1"> Cancellable + line="4056">Cancellable @@ -6468,7 +6610,7 @@ content (for regular files), the metadata, and extended attributes. throws="1"> Load object as a stream; useful when copying objects between + line="4110">Load object as a stream; useful when copying objects between repositories. @@ -6478,19 +6620,19 @@ repositories. Repo + line="4112">Repo Object type + line="4113">Object type ASCII SHA256 checksum + line="4114">ASCII SHA256 checksum transfer-ownership="full"> Stream for object + line="4115">Stream for object transfer-ownership="full"> Length of @out_input + line="4116">Length of @out_input allow-none="1"> Cancellable + line="4117">Cancellable @@ -6527,7 +6669,7 @@ repositories. throws="1"> Load the metadata object @sha256 of type @objtype, storing the + line="4517">Load the metadata object @sha256 of type @objtype, storing the result in @out_variant. @@ -6537,19 +6679,19 @@ result in @out_variant. Repo + line="4519">Repo Expected object type + line="4520">Expected object type Checksum string + line="4521">Checksum string transfer-ownership="full"> Metadata object + line="4522">Metadata object @@ -6568,7 +6710,7 @@ result in @out_variant. throws="1"> Attempt to load the metadata object @sha256 of type @objtype if it + line="4494">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. @@ -6579,19 +6721,19 @@ exists, storing the result in @out_variant. If it doesn't exist, Repo + line="4496">Repo Object type + line="4497">Object type ASCII checksum + line="4498">ASCII checksum Metadata + line="4499">Metadata @@ -6611,7 +6753,7 @@ exists, storing the result in @out_variant. If it doesn't exist, throws="1"> Commits in the "partial" state do not have all their child objects + line="2106">Commits in the "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. @@ -6626,19 +6768,19 @@ should use this if you are implementing a different type of transport. Repo + line="2108">Repo Commit SHA-256 + line="2109">Commit SHA-256 Whether or not this commit is partial + line="2110">Whether or not this commit is partial @@ -6649,7 +6791,7 @@ should use this if you are implementing a different type of transport. throws="1"> Allows the setting of a reason code for a partial commit. Presently + line="2055">Allows the setting of a reason code for a partial commit. Presently it only supports setting reason bitmask to OSTREE_REPO_COMMIT_STATE_FSCK_PARTIAL, or OSTREE_REPO_COMMIT_STATE_NORMAL. This will allow successive ostree @@ -6664,25 +6806,25 @@ it. Repo + line="2057">Repo Commit SHA-256 + line="2058">Commit SHA-256 Whether or not this commit is partial + line="2059">Whether or not this commit is partial Reason bitmask for partial commit + line="2060">Reason bitmask for partial commit @@ -6709,7 +6851,7 @@ it. throws="1"> Starts or resumes a transaction. In order to write to a repo, you + line="1734">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 ostree_repo_abort_transaction(). @@ -6734,7 +6876,7 @@ active at a time. An #OstreeRepo + line="1736">An #OstreeRepo allow-none="1"> Whether this transaction + line="1737">Whether this transaction is resuming from a previous one. This is a legacy state, now OSTree pulls use per-commit `state/.commitpartial` files. @@ -6756,7 +6898,7 @@ pulls use per-commit `state/.commitpartial` files. allow-none="1"> Cancellable + line="1740">Cancellable @@ -6959,7 +7101,7 @@ non existing commit Connect to the remote repository, fetching the specified set of + line="4695">Connect to the remote repository, fetching the specified set of refs @refs_to_fetch. For each ref that is changed, download the commit, all metadata, and all content objects, storing them safely on disk in @self. @@ -6983,13 +7125,13 @@ one around this call. Repo + line="4697">Repo Name of remote + line="4698">Name of remote allow-none="1"> Optional list of refs; if %NULL, fetch all configured refs + line="4699">Optional list of refs; if %NULL, fetch all configured refs @@ -7006,7 +7148,7 @@ one around this call. Options controlling fetch behavior + line="4700">Options controlling fetch behavior allow-none="1"> Progress + line="4701">Progress allow-none="1"> Cancellable + line="4702">Cancellable @@ -7181,7 +7323,7 @@ ostree_repo_pull_from_remotes_async(). throws="1"> This is similar to ostree_repo_pull(), but only fetches a single + line="4734">This is similar to ostree_repo_pull(), but only fetches a single subpath. @@ -7191,19 +7333,19 @@ subpath. Repo + line="4736">Repo Name of remote + line="4737">Name of remote Subdirectory path + line="4738">Subdirectory path allow-none="1"> Optional list of refs; if %NULL, fetch all configured refs + line="4739">Optional list of refs; if %NULL, fetch all configured refs @@ -7220,7 +7362,7 @@ subpath. Options controlling fetch behavior + line="4740">Options controlling fetch behavior allow-none="1"> Progress + line="4741">Progress allow-none="1"> Cancellable + line="4742">Cancellable @@ -7333,7 +7475,7 @@ The following are currently defined: throws="1"> Return the size in bytes of object with checksum @sha256, after any + line="4458">Return the size in bytes of object with checksum @sha256, after any compression has been applied. @@ -7343,19 +7485,19 @@ compression has been applied. Repo + line="4460">Repo Object type + line="4461">Object type Checksum + line="4462">Checksum transfer-ownership="full"> Size in bytes object occupies physically + line="4463">Size in bytes object occupies physically allow-none="1"> Cancellable + line="4464">Cancellable @@ -7383,7 +7525,7 @@ compression has been applied. throws="1"> Load the content for @rev into @out_root. + line="4660">Load the content for @rev into @out_root. @@ -7392,13 +7534,13 @@ compression has been applied. Repo + line="4662">Repo Ref or ASCII checksum + line="4663">Ref or ASCII checksum transfer-ownership="full"> An #OstreeRepoFile corresponding to the root + line="4664">An #OstreeRepoFile corresponding to the root transfer-ownership="full"> The resolved commit checksum + line="4665">The resolved commit checksum allow-none="1"> Cancellable + line="4666">Cancellable @@ -7435,7 +7577,7 @@ compression has been applied. throws="1"> OSTree commits can have arbitrary metadata associated; this + line="3045">OSTree commits can have arbitrary metadata associated; this function retrieves them. If none exists, @out_metadata will be set to %NULL. @@ -7446,13 +7588,13 @@ to %NULL. Repo + line="3047">Repo ASCII SHA256 commit checksum + line="3048">ASCII SHA256 commit checksum transfer-ownership="full"> Metadata associated with commit in with format "a{sv}", or %NULL if none exists + line="3049">Metadata associated with commit in with format "a{sv}", or %NULL if none exists allow-none="1"> Cancellable + line="3050">Cancellable @@ -7480,7 +7622,7 @@ to %NULL. throws="1"> An OSTree repository can contain a high level "summary" file that + line="5748">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 @@ -7506,7 +7648,7 @@ Locking: exclusive Repo + line="5750">Repo allow-none="1"> A GVariant of type a{sv}, or %NULL + line="5751">A GVariant of type a{sv}, or %NULL allow-none="1"> Cancellable + line="5752">Cancellable @@ -7535,7 +7677,7 @@ Locking: exclusive throws="1"> By default, an #OstreeRepo will cache the remote configuration and its + line="3230">By default, an #OstreeRepo will cache the remote configuration and its own repo/config data. This API can be used to reload it. @@ -7545,7 +7687,7 @@ own repo/config data. This API can be used to reload it. repo + line="3232">repo allow-none="1"> cancellable + line="3233">cancellable @@ -7564,7 +7706,7 @@ own repo/config data. This API can be used to reload it. throws="1"> Create a new remote named @name pointing to @url. If @options is + line="1652">Create a new remote named @name pointing to @url. If @options is 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: @@ -7579,19 +7721,19 @@ mapped as follows: Repo + line="1654">Repo Name of remote + line="1655">Name of remote URL for remote (if URL begins with metalink=, it will be used as such) + line="1656">URL for remote (if URL begins with metalink=, it will be used as such) GVariant of type a{sv} + line="1657">GVariant of type a{sv} Cancellable + line="1658">Cancellable @@ -7619,7 +7761,7 @@ mapped as follows: throws="1"> A combined function handling the equivalent of + line="1840">A combined function handling the equivalent of ostree_repo_remote_add(), ostree_repo_remote_delete(), with more options. @@ -7630,7 +7772,7 @@ options. Repo + line="1842">Repo allow-none="1"> System root + line="1843">System root Operation to perform + line="1844">Operation to perform Name of remote + line="1845">Name of remote URL for remote (if URL begins with metalink=, it will be used as such) + line="1846">URL for remote (if URL begins with metalink=, it will be used as such) allow-none="1"> GVariant of type a{sv} + line="1847">GVariant of type a{sv} allow-none="1"> Cancellable + line="1848">Cancellable @@ -7685,7 +7827,7 @@ options. throws="1"> Delete the remote named @name. It is an error if the provided + line="1738">Delete the remote named @name. It is an error if the provided remote does not exist. @@ -7695,13 +7837,13 @@ remote does not exist. Repo + line="1740">Repo Name of remote + line="1741">Name of remote allow-none="1"> Cancellable + line="1742">Cancellable @@ -7720,7 +7862,7 @@ remote does not exist. throws="1"> Tries to fetch the summary file and any GPG signatures on the summary file + line="2354">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 respectively. @@ -7737,20 +7879,20 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string. %TRUE on success, %FALSE on failure + line="2379">%TRUE on success, %FALSE on failure Self + line="2356">Self name of a remote + line="2357">name of a remote allow-none="1"> return location for raw summary data, or + line="2358">return location for raw summary data, or %NULL @@ -7773,7 +7915,7 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string. allow-none="1"> return location for raw summary + line="2360">return location for raw summary signature data, or %NULL @@ -7783,7 +7925,7 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string. allow-none="1"> a #GCancellable + line="2362">a #GCancellable @@ -7872,27 +8014,27 @@ The following are currently defined: throws="1"> Return whether GPG verification is enabled for the remote named @name + line="2001">Return whether GPG verification is enabled for the remote named @name through @out_gpg_verify. It is an error if the provided remote does not exist. %TRUE on success, %FALSE on failure + line="2012">%TRUE on success, %FALSE on failure Repo + line="2003">Repo Name of remote + line="2004">Name of remote allow-none="1"> Remote's GPG option + line="2005">Remote's GPG option @@ -7913,27 +8055,27 @@ not exist. throws="1"> Return whether GPG verification of the summary is enabled for the remote + line="2044">Return whether GPG verification of the summary is enabled for the remote named @name through @out_gpg_verify_summary. It is an error if the provided remote does not exist. %TRUE on success, %FALSE on failure + line="2055">%TRUE on success, %FALSE on failure Repo + line="2046">Repo Name of remote + line="2047">Name of remote allow-none="1"> Remote's GPG option + line="2048">Remote's GPG option @@ -7954,26 +8096,26 @@ remote does not exist. throws="1"> Return the URL of the remote named @name through @out_url. It is an + line="1958">Return the URL of the remote named @name through @out_url. It is an error if the provided remote does not exist. %TRUE on success, %FALSE on failure + line="1968">%TRUE on success, %FALSE on failure Repo + line="1960">Repo Name of remote + line="1961">Name of remote allow-none="1"> Remote's URL + line="1962">Remote's URL @@ -7994,7 +8136,7 @@ error if the provided remote does not exist. throws="1"> Imports one or more GPG keys from the open @source_stream, or from the + line="2076">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 array can optionally restrict which keys are imported. If @key_ids is %NULL, then all keys are imported. @@ -8005,20 +8147,20 @@ from the remote named @name. %TRUE on success, %FALSE on failure + line="2095">%TRUE on success, %FALSE on failure Self + line="2078">Self name of a remote + line="2079">name of a remote allow-none="1"> a #GInputStream, or %NULL + line="2080">a #GInputStream, or %NULL allow-none="1"> a %NULL-terminated array of GPG key IDs, or %NULL + line="2081">a %NULL-terminated array of GPG key IDs, or %NULL @@ -8049,7 +8191,7 @@ from the remote named @name. allow-none="1"> return location for the number of imported + line="2082">return location for the number of imported keys, or %NULL @@ -8059,7 +8201,7 @@ from the remote named @name. allow-none="1"> a #GCancellable + line="2084">a #GCancellable @@ -8067,13 +8209,13 @@ from the remote named @name. List available remote names in an #OstreeRepo. Remote names are sorted + line="1907">List available remote names in an #OstreeRepo. Remote names are sorted alphabetically. If no remotes are available the function returns %NULL. a %NULL-terminated + line="1915">a %NULL-terminated array of remote names @@ -8083,7 +8225,7 @@ alphabetically. If no remotes are available the function returns %NULL. Repo + line="1909">Repo allow-none="1"> Number of remotes available + line="1910">Number of remotes available @@ -8420,7 +8562,7 @@ using it has no effect. throws="1"> This function is deprecated in favor of using ostree_repo_devino_cache_new(), + line="1697">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 `ostree_repo_write_directory_to_mtree()`. @@ -8445,7 +8587,7 @@ Multithreading: This function is *not* MT safe. An #OstreeRepo + line="1699">An #OstreeRepo allow-none="1"> Cancellable + line="1700">Cancellable @@ -8465,7 +8607,7 @@ Multithreading: This function is *not* MT safe. throws="1"> Like ostree_repo_set_ref_immediate(), but creates an alias. + line="2274">Like ostree_repo_set_ref_immediate(), but creates an alias. @@ -8474,7 +8616,7 @@ Multithreading: This function is *not* MT safe. An #OstreeRepo + line="2276">An #OstreeRepo allow-none="1"> A remote for the ref + line="2277">A remote for the ref The ref to write + line="2278">The ref to write allow-none="1"> The ref target to point it to, or %NULL to unset + line="2279">The ref target to point it to, or %NULL to unset allow-none="1"> GCancellable + line="2280">GCancellable @@ -8518,7 +8660,7 @@ Multithreading: This function is *not* MT safe. throws="1"> Set a custom location for the cache directory used for e.g. + line="3392">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 write permissions in the repo, where the cache is normally stored. @@ -8530,19 +8672,19 @@ write permissions in the repo, where the cache is normally stored. An #OstreeRepo + line="3394">An #OstreeRepo directory fd + line="3395">directory fd subpath in @dfd + line="3396">subpath in @dfd allow-none="1"> a #GCancellable + line="3397">a #GCancellable @@ -8562,21 +8704,21 @@ write permissions in the repo, where the cache is normally stored. throws="1"> Set or clear the collection ID of this repository. See [collection IDs][collection-ids]. + line="6211">Set or clear the collection ID of this repository. See [collection IDs][collection-ids]. The update will be made in memory, but must be written out to the repository configuration on disk using ostree_repo_write_config(). %TRUE on success, %FALSE otherwise + line="6221">%TRUE on success, %FALSE otherwise an #OstreeRepo + line="6213">an #OstreeRepo allow-none="1"> new collection ID, or %NULL to unset it + line="6214">new collection ID, or %NULL to unset it @@ -8596,27 +8738,27 @@ configuration on disk using ostree_repo_write_config(). throws="1"> This is like ostree_repo_transaction_set_collection_ref(), except it may be + line="2300">This is like ostree_repo_transaction_set_collection_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. %TRUE on success, %FALSE otherwise + line="2312">%TRUE on success, %FALSE otherwise An #OstreeRepo + line="2302">An #OstreeRepo The collection–ref to write + line="2303">The collection–ref to write allow-none="1"> The checksum to point it to, or %NULL to unset + line="2304">The checksum to point it to, or %NULL to unset allow-none="1"> GCancellable + line="2305">GCancellable @@ -8643,7 +8785,7 @@ case where we're creating or overwriting an existing ref. c:identifier="ostree_repo_set_disable_fsync"> Disable requests to fsync() to stable storage during commits. This + line="3375">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 ensuring data consistency. @@ -8655,13 +8797,13 @@ ensuring data consistency. An #OstreeRepo + line="3377">An #OstreeRepo If %TRUE, do not fsync + line="3378">If %TRUE, do not fsync @@ -8671,7 +8813,7 @@ ensuring data consistency. throws="1"> This is like ostree_repo_transaction_set_ref(), except it may be + line="2246">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. @@ -8684,7 +8826,7 @@ Multithreading: This function is MT safe. An #OstreeRepo + line="2248">An #OstreeRepo allow-none="1"> A remote for the ref + line="2249">A remote for the ref The ref to write + line="2250">The ref to write allow-none="1"> The checksum to point it to, or %NULL to unset + line="2251">The checksum to point it to, or %NULL to unset allow-none="1"> GCancellable + line="2252">GCancellable @@ -8727,7 +8869,7 @@ Multithreading: This function is MT safe. throws="1"> Add a GPG signature to a commit. + line="5065">Add a GPG signature to a commit. @@ -8736,19 +8878,19 @@ Multithreading: This function is MT safe. Self + line="5067">Self SHA256 of given commit to sign + line="5068">SHA256 of given commit to sign Use this GPG key id + line="5069">Use this GPG key id allow-none="1"> GPG home directory, or %NULL + line="5070">GPG home directory, or %NULL allow-none="1"> A #GCancellable + line="5071">A #GCancellable @@ -8776,7 +8918,7 @@ Multithreading: This function is MT safe. throws="1"> This function is deprecated, sign the summary file instead. + line="5154">This function is deprecated, sign the summary file instead. Add a GPG signature to a static delta. @@ -8786,31 +8928,31 @@ Add a GPG signature to a static delta. Self + line="5156">Self From commit + line="5157">From commit To commit + line="5158">To commit key id + line="5159">key id homedir + line="5160">homedir allow-none="1"> cancellable + line="5161">cancellable @@ -8953,7 +9095,7 @@ are known: version="2018.6"> If @checksum is not %NULL, then record it as the target of local ref named + line="2208">If @checksum is not %NULL, then record it as the target of local ref named @ref. Otherwise, if @checksum is %NULL, then record that the ref should @@ -8973,13 +9115,13 @@ Multithreading: Since v2017.15 this function is MT safe. An #OstreeRepo + line="2210">An #OstreeRepo The collection–ref to write + line="2211">The collection–ref to write allow-none="1"> The checksum to point it to + line="2212">The checksum to point it to @@ -8997,7 +9139,7 @@ Multithreading: Since v2017.15 this function is MT safe. c:identifier="ostree_repo_transaction_set_ref"> If @checksum is not %NULL, then record it as the target of ref named + line="2159">If @checksum 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. @@ -9026,7 +9168,7 @@ Multithreading: Since v2017.15 this function is MT safe. An #OstreeRepo + line="2161">An #OstreeRepo allow-none="1"> A remote for the ref + line="2162">A remote for the ref The ref to write + line="2163">The ref to write allow-none="1"> The checksum to point it to + line="2164">The checksum to point it to @@ -9059,7 +9201,7 @@ Multithreading: Since v2017.15 this function is MT safe. c:identifier="ostree_repo_transaction_set_refspec"> Like ostree_repo_transaction_set_ref(), but takes concatenated + line="2134">Like ostree_repo_transaction_set_ref(), but takes concatenated @refspec format as input instead of separate remote and name arguments. @@ -9072,13 +9214,13 @@ Multithreading: Since v2017.15 this function is MT safe. An #OstreeRepo + line="2136">An #OstreeRepo The refspec to write + line="2137">The refspec to write allow-none="1"> The checksum to point it to + line="2138">The checksum to point it to @@ -9312,26 +9454,26 @@ Locking: shared throws="1"> Check for a valid GPG signature on commit named by the ASCII + line="5485">Check for a valid GPG signature on commit named by the ASCII checksum @commit_checksum. %TRUE if there was a GPG signature from a trusted keyring, otherwise %FALSE + line="5497">%TRUE if there was a GPG signature from a trusted keyring, otherwise %FALSE Repository + line="5487">Repository ASCII SHA256 checksum + line="5488">ASCII SHA256 checksum allow-none="1"> Path to directory GPG keyrings; overrides built-in default if given + line="5489">Path to directory GPG keyrings; overrides built-in default if given allow-none="1"> Path to additional keyring file (not a directory) + line="5490">Path to additional keyring file (not a directory) allow-none="1"> Cancellable + line="5491">Cancellable @@ -9368,26 +9510,26 @@ checksum @commit_checksum. throws="1"> Read GPG signature(s) on the commit named by the ASCII checksum + line="5526">Read GPG signature(s) on the commit named by the ASCII checksum @commit_checksum and return detailed results. an #OstreeGpgVerifyResult, or %NULL on error + line="5538">an #OstreeGpgVerifyResult, or %NULL on error Repository + line="5528">Repository ASCII SHA256 checksum + line="5529">ASCII SHA256 checksum allow-none="1"> Path to directory GPG keyrings; overrides built-in default if given + line="5530">Path to directory GPG keyrings; overrides built-in default if given allow-none="1"> Path to additional keyring file (not a directory) + line="5531">Path to additional keyring file (not a directory) allow-none="1"> Cancellable + line="5532">Cancellable @@ -9425,33 +9567,33 @@ checksum @commit_checksum. throws="1"> Read GPG signature(s) on the commit named by the ASCII checksum + line="5564">Read GPG signature(s) on the commit named by the ASCII checksum @commit_checksum and return detailed results, based on the keyring configured for @remote. an #OstreeGpgVerifyResult, or %NULL on error + line="5576">an #OstreeGpgVerifyResult, or %NULL on error Repository + line="5566">Repository ASCII SHA256 checksum + line="5567">ASCII SHA256 checksum OSTree remote to use for configuration + line="5568">OSTree remote to use for configuration allow-none="1"> Cancellable + line="5569">Cancellable @@ -9470,38 +9612,38 @@ configured for @remote. throws="1"> Verify @signatures for @summary data using GPG keys in the keyring for + line="5655">Verify @signatures for @summary data using GPG keys in the keyring for @remote_name, and return an #OstreeGpgVerifyResult. an #OstreeGpgVerifyResult, or %NULL on error + line="5667">an #OstreeGpgVerifyResult, or %NULL on error Repo + line="5657">Repo Name of remote + line="5658">Name of remote Summary data as a #GBytes + line="5659">Summary data as a #GBytes Summary signatures as a #GBytes + line="5660">Summary signatures as a #GBytes allow-none="1"> Cancellable + line="5661">Cancellable @@ -9520,7 +9662,7 @@ configured for @remote. throws="1"> Import an archive file @archive into the repository, and write its + line="937">Import an archive file @archive into the repository, and write its file structure to @mtree. @@ -9530,19 +9672,19 @@ file structure to @mtree. An #OstreeRepo + line="939">An #OstreeRepo A path to an archive file + line="940">A path to an archive file The #OstreeMutableTree to write to + line="941">The #OstreeMutableTree to write to allow-none="1"> Optional commit modifier + line="942">Optional commit modifier Autocreate parent directories + line="943">Autocreate parent directories allow-none="1"> Cancellable + line="944">Cancellable @@ -9577,7 +9719,7 @@ file structure to @mtree. throws="1"> Read an archive from @fd and import it into the repository, writing + line="972">Read an archive from @fd and import it into the repository, writing its file structure to @mtree. @@ -9587,19 +9729,19 @@ its file structure to @mtree. An #OstreeRepo + line="974">An #OstreeRepo A file descriptor to read the archive from + line="975">A file descriptor to read the archive from The #OstreeMutableTree to write to + line="976">The #OstreeMutableTree to write to allow-none="1"> Optional commit modifier + line="977">Optional commit modifier Autocreate parent directories + line="978">Autocreate parent directories allow-none="1"> Cancellable + line="979">Cancellable @@ -9634,7 +9776,7 @@ its file structure to @mtree. throws="1"> Write a commit metadata object, referencing @root_contents_checksum + line="2959">Write a commit metadata object, referencing @root_contents_checksum and @root_metadata_checksum. @@ -9644,7 +9786,7 @@ and @root_metadata_checksum. Repo + line="2961">Repo allow-none="1"> ASCII SHA256 checksum for parent, or %NULL for none + line="2962">ASCII SHA256 checksum for parent, or %NULL for none allow-none="1"> Subject + line="2963">Subject allow-none="1"> Body + line="2964">Body allow-none="1"> GVariant of type a{sv}, or %NULL for none + line="2965">GVariant of type a{sv}, or %NULL for none The tree to point the commit to + line="2966">The tree to point the commit to transfer-ownership="full"> Resulting ASCII SHA256 checksum for commit + line="2967">Resulting ASCII SHA256 checksum for commit allow-none="1"> Cancellable + line="2968">Cancellable @@ -9714,7 +9856,7 @@ and @root_metadata_checksum. throws="1"> Replace any existing metadata associated with commit referred to by + line="3093">Replace any existing metadata associated with commit referred to by @checksum with @metadata. If @metadata is %NULL, then existing data will be deleted. @@ -9725,13 +9867,13 @@ data will be deleted. Repo + line="3095">Repo ASCII SHA256 commit checksum + line="3096">ASCII SHA256 commit checksum allow-none="1"> Metadata to associate with commit in with format "a{sv}", or %NULL to delete + line="3097">Metadata to associate with commit in with format "a{sv}", or %NULL to delete allow-none="1"> Cancellable + line="3098">Cancellable @@ -9759,7 +9901,7 @@ data will be deleted. throws="1"> Write a commit metadata object, referencing @root_contents_checksum + line="2991">Write a commit metadata object, referencing @root_contents_checksum and @root_metadata_checksum. @@ -9769,7 +9911,7 @@ and @root_metadata_checksum. Repo + line="2993">Repo allow-none="1"> ASCII SHA256 checksum for parent, or %NULL for none + line="2994">ASCII SHA256 checksum for parent, or %NULL for none allow-none="1"> Subject + line="2995">Subject allow-none="1"> Body + line="2996">Body allow-none="1"> GVariant of type a{sv}, or %NULL for none + line="2997">GVariant of type a{sv}, or %NULL for none The tree to point the commit to + line="2998">The tree to point the commit to The time to use to stamp the commit + line="2999">The time to use to stamp the commit transfer-ownership="full"> Resulting ASCII SHA256 checksum for commit + line="3000">Resulting ASCII SHA256 checksum for commit allow-none="1"> Cancellable + line="3001">Cancellable @@ -9845,7 +9987,7 @@ and @root_metadata_checksum. throws="1"> Save @new_config in place of this repository's config file. + line="1464">Save @new_config in place of this repository's config file. @@ -9854,13 +9996,13 @@ and @root_metadata_checksum. Repo + line="1466">Repo Overwrite the config file with this data + line="1467">Overwrite the config file with this data @@ -9870,7 +10012,7 @@ and @root_metadata_checksum. throws="1"> Store the content object streamed as @object_input, + line="2784">Store the content object streamed as @object_input, with total length @length. The actual checksum will be returned as @out_csum. @@ -9881,7 +10023,7 @@ be returned as @out_csum. Repo + line="2786">Repo allow-none="1"> If provided, validate content against this checksum + line="2787">If provided, validate content against this checksum Content object stream + line="2788">Content object stream Length of @object_input + line="2789">Length of @object_input allow-none="1"> Binary checksum + line="2790">Binary checksum @@ -9924,7 +10066,7 @@ be returned as @out_csum. allow-none="1"> Cancellable + line="2791">Cancellable @@ -9933,7 +10075,7 @@ be returned as @out_csum. c:identifier="ostree_repo_write_content_async"> Asynchronously store the content object @object. If provided, the + line="2882">Asynchronously store the content object @object. If provided, the checksum @expected_checksum will be verified. @@ -9943,7 +10085,7 @@ checksum @expected_checksum will be verified. Repo + line="2884">Repo allow-none="1"> If provided, validate content against this checksum + line="2885">If provided, validate content against this checksum Input + line="2886">Input Length of @object + line="2887">Length of @object allow-none="1"> Cancellable + line="2888">Cancellable closure="5"> Invoked when content is writed + line="2889">Invoked when content is writed allow-none="1"> User data for @callback + line="2890">User data for @callback @@ -10003,7 +10145,7 @@ checksum @expected_checksum will be verified. throws="1"> Completes an invocation of ostree_repo_write_content_async(). + line="2923">Completes an invocation of ostree_repo_write_content_async(). @@ -10012,13 +10154,13 @@ checksum @expected_checksum will be verified. a #OstreeRepo + line="2925">a #OstreeRepo a #GAsyncResult + line="2926">a #GAsyncResult transfer-ownership="full"> A binary SHA256 checksum of the content object + line="2927">A binary SHA256 checksum of the content object @@ -10037,7 +10179,7 @@ checksum @expected_checksum will be verified. throws="1"> Store the content object streamed as @object_input, with total + line="2757">Store the content object streamed as @object_input, with total length @length. The given @checksum will be treated as trusted. This function should be used when importing file objects from local @@ -10050,25 +10192,25 @@ disk, for example. Repo + line="2759">Repo Store content using this ASCII SHA256 checksum + line="2760">Store content using this ASCII SHA256 checksum Content stream + line="2761">Content stream Length of @object_input + line="2762">Length of @object_input allow-none="1"> Cancellable + line="2763">Cancellable @@ -10087,7 +10229,7 @@ disk, for example. throws="1"> Store as objects all contents of the directory referred to by @dfd + line="4051">Store as objects all contents of the directory referred to by @dfd and @path all children into the repository @self, overlaying the resulting filesystem hierarchy into @mtree. @@ -10098,25 +10240,25 @@ resulting filesystem hierarchy into @mtree. Repo + line="4053">Repo Directory file descriptor + line="4054">Directory file descriptor Path + line="4055">Path Overlay directory contents into this tree + line="4056">Overlay directory contents into this tree allow-none="1"> Optional modifier + line="4057">Optional modifier @@ -10135,7 +10277,7 @@ resulting filesystem hierarchy into @mtree. allow-none="1"> Cancellable + line="4058">Cancellable @@ -10145,7 +10287,7 @@ resulting filesystem hierarchy into @mtree. throws="1"> Store objects for @dir and all children into the repository @self, + line="4010">Store objects for @dir and all children into the repository @self, overlaying the resulting filesystem hierarchy into @mtree. @@ -10155,19 +10297,19 @@ overlaying the resulting filesystem hierarchy into @mtree. Repo + line="4012">Repo Path to a directory + line="4013">Path to a directory Overlay directory contents into this tree + line="4014">Overlay directory contents into this tree allow-none="1"> Optional modifier + line="4015">Optional modifier @@ -10186,7 +10328,7 @@ overlaying the resulting filesystem hierarchy into @mtree. allow-none="1"> Cancellable + line="4016">Cancellable @@ -10196,7 +10338,7 @@ overlaying the resulting filesystem hierarchy into @mtree. throws="1"> Store the metadata object @object. Return the checksum + line="2487">Store the metadata object @object. Return the checksum as @out_csum. If @expected_checksum is not %NULL, verify it against the @@ -10209,13 +10351,13 @@ computed checksum. Repo + line="2489">Repo Object type + line="2490">Object type allow-none="1"> If provided, validate content against this checksum + line="2491">If provided, validate content against this checksum Metadata + line="2492">Metadata allow-none="1"> Binary checksum + line="2493">Binary checksum @@ -10252,7 +10394,7 @@ computed checksum. allow-none="1"> Cancellable + line="2494">Cancellable @@ -10261,7 +10403,7 @@ computed checksum. c:identifier="ostree_repo_write_metadata_async"> Asynchronously store the metadata object @variant. If provided, + line="2666">Asynchronously store the metadata object @variant. If provided, the checksum @expected_checksum will be verified. @@ -10271,13 +10413,13 @@ the checksum @expected_checksum will be verified. Repo + line="2668">Repo Object type + line="2669">Object type allow-none="1"> If provided, validate content against this checksum + line="2670">If provided, validate content against this checksum Metadata + line="2671">Metadata allow-none="1"> Cancellable + line="2672">Cancellable closure="5"> Invoked when metadata is writed + line="2673">Invoked when metadata is writed allow-none="1"> Data for @callback + line="2674">Data for @callback @@ -10331,7 +10473,7 @@ the checksum @expected_checksum will be verified. throws="1"> Complete a call to ostree_repo_write_metadata_async(). + line="2707">Complete a call to ostree_repo_write_metadata_async(). @@ -10340,13 +10482,13 @@ the checksum @expected_checksum will be verified. Repo + line="2709">Repo Result + line="2710">Result transfer-ownership="full"> Binary checksum value + line="2711">Binary checksum value @@ -10367,7 +10509,7 @@ the checksum @expected_checksum will be verified. throws="1"> Store the metadata object @variant; the provided @checksum is + line="2564">Store the metadata object @variant; the provided @checksum is trusted. @@ -10377,31 +10519,31 @@ trusted. Repo + line="2566">Repo Object type + line="2567">Object type Store object with this ASCII SHA256 checksum + line="2568">Store object with this ASCII SHA256 checksum Metadata object stream + line="2569">Metadata object stream Length, may be 0 for unknown + line="2570">Length, may be 0 for unknown allow-none="1"> Cancellable + line="2571">Cancellable @@ -10420,7 +10562,7 @@ trusted. throws="1"> Store the metadata object @variant; the provided @checksum is + line="2601">Store the metadata object @variant; the provided @checksum is trusted. @@ -10430,25 +10572,25 @@ trusted. Repo + line="2603">Repo Object type + line="2604">Object type Store object with this ASCII SHA256 checksum + line="2605">Store object with this ASCII SHA256 checksum Metadata object + line="2606">Metadata object allow-none="1"> Cancellable + line="2607">Cancellable @@ -10467,7 +10609,7 @@ trusted. throws="1"> Write all metadata objects for @mtree to repo; the resulting + line="4101">Write all metadata objects for @mtree to repo; the resulting @out_file points to the %OSTREE_OBJECT_TYPE_DIR_TREE object that the @mtree represented. @@ -10478,13 +10620,13 @@ the @mtree represented. Repo + line="4103">Repo Mutable tree + line="4104">Mutable tree transfer-ownership="full"> An #OstreeRepoFile representing @mtree's root. + line="4105">An #OstreeRepoFile representing @mtree's root. allow-none="1"> Cancellable + line="4106">Cancellable @@ -10513,7 +10655,7 @@ the @mtree represented. transfer-ownership="none"> Path to repository. Note that if this repository was created + line="1126">Path to repository. Note that if this repository was created via `ostree_repo_new_at()`, this value will refer to a value in the Linux kernel's `/proc/self/fd` directory. Generally, you should avoid using this property at all; you can gain a reference @@ -10527,7 +10669,7 @@ use file-descriptor relative operations. transfer-ownership="none"> Path to directory containing remote definitions. The default is `NULL`. + line="1159">Path to directory containing remote definitions. The default is `NULL`. If a `sysroot-path` property is defined, this value will default to `${sysroot_path}/etc/ostree/remotes.d`. @@ -10540,7 +10682,7 @@ This value will only be used for system repositories. transfer-ownership="none"> A system using libostree for the host has a "system" repository; this + line="1141">A system using libostree for the host has a "system" repository; this property will be set for repositories referenced via `ostree_sysroot_repo()` for example. @@ -10552,7 +10694,7 @@ object via `ostree_sysroot_repo()`. Emitted during a pull operation upon GPG verification (if enabled). + line="1177">Emitted during a pull operation upon GPG verification (if enabled). Applications can connect to this signal to output the verification results if desired. @@ -10566,13 +10708,13 @@ is called. checksum of the signed object + line="1180">checksum of the signed object an #OstreeGpgVerifyResult + line="1181">an #OstreeGpgVerifyResult @@ -10937,14 +11079,14 @@ ostree_repo_checkout_tree(). A new commit modifier. + line="4189">A new commit modifier. Control options for filter + line="4184">Control options for filter @@ -10957,7 +11099,7 @@ ostree_repo_checkout_tree(). destroy="3"> Function that can inspect individual files + line="4185">Function that can inspect individual files allow-none="1"> User data + line="4186">User data scope="async"> A #GDestroyNotify + line="4187">A #GDestroyNotify @@ -10996,7 +11138,7 @@ ostree_repo_checkout_tree(). version="2017.13"> See the documentation for + line="4282">See the documentation for `ostree_repo_devino_cache_new()`. This function can then be used for later calls to `ostree_repo_write_directory_to_mtree()` to optimize commits. @@ -11014,14 +11156,14 @@ should avoid further mutation of the cache. Modifier + line="4284">Modifier A hash table caching device,inode to checksums + line="4285">A hash table caching device,inode to checksums @@ -11030,7 +11172,7 @@ should avoid further mutation of the cache. c:identifier="ostree_repo_commit_modifier_set_sepolicy"> If @policy is non-%NULL, use it to look up labels to use for + line="4260">If @policy 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 @@ -11046,7 +11188,7 @@ policy wins. An #OstreeRepoCommitModifier + line="4262">An #OstreeRepoCommitModifier @@ -11056,7 +11198,7 @@ policy wins. allow-none="1"> Policy to use for labeling + line="4263">Policy to use for labeling @@ -11065,7 +11207,7 @@ policy wins. c:identifier="ostree_repo_commit_modifier_set_xattr_callback"> If set, this function should return extended attributes to use for + line="4237">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 repository. @@ -11077,7 +11219,7 @@ repository. An #OstreeRepoCommitModifier + line="4239">An #OstreeRepoCommitModifier @@ -11088,14 +11230,14 @@ repository. destroy="1"> Function to be invoked, should return extended attributes for path + line="4240">Function to be invoked, should return extended attributes for path Destroy notification + line="4241">Destroy notification allow-none="1"> Data for @callback: + line="4242">Data for @callback: @@ -13626,18 +13768,18 @@ ostree_sysroot_new_default(). - + Path to deployment origin file + line="1231">Path to deployment origin file A deployment path + line="1229">A deployment path @@ -13645,9 +13787,9 @@ ostree_sysroot_new_default(). Delete any state that resulted from a partially completed + line="500">Delete any state that resulted from a partially completed transaction, such as incomplete deployments. - + @@ -13655,7 +13797,7 @@ transaction, such as incomplete deployments. Sysroot + line="502">Sysroot allow-none="1"> Cancellable + line="503">Cancellable @@ -13684,7 +13826,7 @@ You generally want to at least set the `OSTREE_REPO_PRUNE_FLAGS_REFS_ONLY` flag in @options. A commit traversal depth of `0` is assumed. Locking: exclusive - + @@ -13744,12 +13886,12 @@ Locking: exclusive throws="1"> Check out deployment tree with revision @revision, performing a 3 + line="2737">Check out deployment tree with revision @revision, performing a 3 way merge with @provided_merge_deployment for configuration. While this API is not deprecated, you most likely want to use the ostree_sysroot_stage_tree() API. - + @@ -13757,7 +13899,7 @@ ostree_sysroot_stage_tree() API. Sysroot + line="2739">Sysroot allow-none="1"> osname to use for merge deployment + line="2740">osname to use for merge deployment Checksum to add + line="2741">Checksum to add allow-none="1"> Origin to use for upgrades + line="2742">Origin to use for upgrades allow-none="1"> Use this deployment for merge path + line="2743">Use this deployment for merge path allow-none="1"> Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment + line="2744">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment @@ -13810,7 +13952,7 @@ ostree_sysroot_stage_tree() API. transfer-ownership="full"> The new deployment path + line="2745">The new deployment path allow-none="1"> Cancellable + line="2746">Cancellable @@ -13829,9 +13971,9 @@ ostree_sysroot_stage_tree() API. throws="1"> Entirely replace the kernel arguments of @deployment with the + line="3081">Entirely replace the kernel arguments of @deployment with the values in @new_kargs. - + @@ -13839,19 +13981,19 @@ values in @new_kargs. Sysroot + line="3083">Sysroot A deployment + line="3084">A deployment Replace deployment's kernel arguments + line="3085">Replace deployment's kernel arguments @@ -13862,7 +14004,7 @@ values in @new_kargs. allow-none="1"> Cancellable + line="3086">Cancellable @@ -13872,10 +14014,10 @@ values in @new_kargs. throws="1"> By default, deployment directories are not mutable. This function + line="3130">By default, deployment directories are not mutable. This function will allow making them temporarily mutable, for example to allow layering additional non-OSTree content. - + @@ -13883,19 +14025,19 @@ layering additional non-OSTree content. Sysroot + line="3132">Sysroot A deployment + line="3133">A deployment Whether or not deployment's files can be changed + line="3134">Whether or not deployment's files can be changed allow-none="1"> Cancellable + line="3135">Cancellable @@ -13915,7 +14057,7 @@ layering additional non-OSTree content. throws="1"> By default, deployments may be subject to garbage collection. Typical uses of + line="2050">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 metadata bit will be set causing libostree to avoid automatic GC of the deployment. However, this is really an "advisory" note; it's still possible @@ -13924,7 +14066,7 @@ for e.g. older versions of libostree unaware of pinning to GC the deployment. This function does nothing and returns successfully if the deployment is already in the desired pinning state. It is an error to try to pin the staged deployment (as it's not in the bootloader entries). - + @@ -13932,19 +14074,19 @@ the staged deployment (as it's not in the bootloader entries). Sysroot + line="2052">Sysroot A deployment + line="2053">A deployment Whether or not deployment will be automatically GC'd + line="2054">Whether or not deployment will be automatically GC'd @@ -13955,13 +14097,13 @@ the staged deployment (as it's not in the bootloader entries). throws="1"> Configure the target deployment @deployment such that it + line="1854">Configure the target deployment @deployment such that it is writable. There are multiple modes, essentially differing in whether or not any changes persist across reboot. The `OSTREE_DEPLOYMENT_UNLOCKED_HOTFIX` state is persistent across reboots. - + @@ -13969,19 +14111,19 @@ across reboots. Sysroot + line="1856">Sysroot Deployment + line="1857">Deployment Transition to this unlocked state + line="1858">Transition to this unlocked state @@ -13991,7 +14133,7 @@ across reboots. allow-none="1"> Cancellable + line="1859">Cancellable @@ -14001,9 +14143,9 @@ across reboots. throws="1"> Ensure that @self is set up as a valid rootfs, by creating + line="383">Ensure that @self is set up as a valid rootfs, by creating /ostree/repo, among other things. - + @@ -14011,7 +14153,7 @@ across reboots. Sysroot + line="385">Sysroot allow-none="1"> Cancellable + line="386">Cancellable - + The currently booted deployment, or %NULL if none + line="1148">The currently booted deployment, or %NULL if none Sysroot + line="1146">Sysroot - + @@ -14057,24 +14199,24 @@ across reboots. - + Path to deployment root directory + line="1217">Path to deployment root directory Sysroot + line="1214">Sysroot A deployment + line="1215">A deployment @@ -14083,38 +14225,38 @@ across reboots. c:identifier="ostree_sysroot_get_deployment_dirpath"> Note this function only returns a *relative* path - if you want + line="1191">Note this function only returns a *relative* path - if you want to access, it, you must either use fd-relative api such as openat(), or concatenate it with the full ostree_sysroot_get_path(). - + Path to deployment root directory, relative to sysroot + line="1200">Path to deployment root directory, relative to sysroot Repo + line="1193">Repo A deployment + line="1194">A deployment - + Ordered list of deployments + line="1178">Ordered list of deployments @@ -14123,7 +14265,7 @@ or concatenate it with the full ostree_sysroot_get_path(). Sysroot + line="1176">Sysroot @@ -14131,21 +14273,21 @@ or concatenate it with the full ostree_sysroot_get_path(). Access a file descriptor that refers to the root directory of this -sysroot. ostree_sysroot_load() must have been invoked prior to -calling this function. - + line="320">Access a file descriptor that refers to the root directory of this sysroot. +ostree_sysroot_initialize() (or ostree_sysroot_load()) must have been invoked +prior to calling this function. + A file descriptor valid for the lifetime of @self + line="328">A file descriptor valid for the lifetime of @self Sysroot + line="322">Sysroot @@ -14154,20 +14296,20 @@ calling this function. c:identifier="ostree_sysroot_get_merge_deployment"> Find the deployment to use as a configuration merge source; this is + line="1409">Find the deployment to use as a configuration merge source; this is the first one in the current deployment list which matches osname. - + Configuration merge deployment + line="1417">Configuration merge deployment Sysroot + line="1411">Sysroot allow-none="1"> Operating system group + line="1412">Operating system group - + Path to rootfs + line="260">Path to rootfs @@ -14200,20 +14342,20 @@ the first one in the current deployment list which matches osname. throws="1"> Retrieve the OSTree repository in sysroot @self. The repo is guaranteed to be open + line="1242">Retrieve the OSTree repository in sysroot @self. The repo is guaranteed to be open (see ostree_repo_open()). - + %TRUE on success, %FALSE otherwise + line="1252">%TRUE on success, %FALSE otherwise Sysroot + line="1244">Sysroot allow-none="1"> Repository in sysroot @self + line="1245">Repository in sysroot @self allow-none="1"> Cancellable + line="1246">Cancellable @@ -14241,25 +14383,25 @@ the first one in the current deployment list which matches osname. - + The currently staged deployment, or %NULL if none + line="1162">The currently staged deployment, or %NULL if none Sysroot + line="1160">Sysroot - + @@ -14275,10 +14417,10 @@ the first one in the current deployment list which matches osname. throws="1"> Initialize the directory structure for an "osname", which is a + line="1605">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. - + @@ -14286,13 +14428,13 @@ is required for generating a deployment. Sysroot + line="1607">Sysroot Name group of operating system checkouts + line="1608">Name group of operating system checkouts allow-none="1"> Cancellable + line="1609">Cancellable - + Load deployment list, bootversion, and subbootversion from the -rootfs @self. - + line="883">Subset of ostree_sysroot_load(); performs basic initialization. Notably, one +can invoke `ostree_sysroot_get_fd()` after calling this function. + +It is not necessary to call this function if ostree_sysroot_load() is +invoked. + @@ -14319,7 +14467,47 @@ rootfs @self. Sysroot + line="885">sysroot + + + + + + Can only be invoked after `ostree_sysroot_initialize()`. + + + %TRUE iff the sysroot points to a booted deployment + + + + + Sysroot + + + + + + Load deployment list, bootversion, and subbootversion from the +rootfs @self. + + + + + + + Sysroot allow-none="1"> Cancellable + line="842">Cancellable @@ -14337,7 +14525,7 @@ rootfs @self. c:identifier="ostree_sysroot_load_if_changed" version="2016.4" throws="1"> - + @@ -14345,7 +14533,7 @@ rootfs @self. #OstreeSysroot + line="993">#OstreeSysroot allow-none="1"> Cancellable + line="995">Cancellable @@ -14368,13 +14556,13 @@ rootfs @self. Acquire an exclusive multi-process write lock for @self. This call + line="1459">Acquire an exclusive multi-process write lock for @self. This call blocks until the lock has been acquired. The lock is not reentrant. Release the lock with ostree_sysroot_unlock(). The lock will also be released if @self is deallocated. - + @@ -14382,7 +14570,7 @@ be released if @self is deallocated. Self + line="1461">Self @@ -14390,8 +14578,8 @@ be released if @self is deallocated. An asynchronous version of ostree_sysroot_lock(). - + line="1569">An asynchronous version of ostree_sysroot_lock(). + @@ -14399,7 +14587,7 @@ be released if @self is deallocated. Self + line="1571">Self allow-none="1"> Cancellable + line="1572">Cancellable closure="2"> Callback + line="1573">Callback allow-none="1"> User data + line="1574">User data @@ -14438,8 +14626,8 @@ be released if @self is deallocated. throws="1"> Call when ostree_sysroot_lock_async() is ready. - + line="1588">Call when ostree_sysroot_lock_async() is ready. + @@ -14447,37 +14635,50 @@ be released if @self is deallocated. Self + line="1590">Self Result + line="1591">Result + + + + + + + + + + + - + A new config file which sets @refspec as an origin + line="1448">A new config file which sets @refspec as an origin Sysroot + line="1445">Sysroot A refspec + line="1446">A refspec @@ -14487,9 +14688,9 @@ be released if @self is deallocated. throws="1"> Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments + line="517">Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments and old boot versions, but does NOT prune the repository. - + @@ -14497,7 +14698,7 @@ and old boot versions, but does NOT prune the repository. Sysroot + line="519">Sysroot allow-none="1"> Cancellable + line="520">Cancellable @@ -14516,12 +14717,12 @@ and old boot versions, but does NOT prune the repository. version="2017.7"> Find the pending and rollback deployments for @osname. Pass %NULL for @osname + line="1352">Find the pending and rollback deployments 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, and @rollback will be the next one after the booted deployment, or the deployment after the pending if we're not looking at the booted deployment. - + @@ -14529,7 +14730,7 @@ we're not looking at the booted deployment. Sysroot + line="1354">Sysroot allow-none="1"> "stateroot" name + line="1355">"stateroot" name allow-none="1"> The pending deployment + line="1356">The pending deployment allow-none="1"> The rollback deployment + line="1357">The rollback deployment @@ -14568,21 +14769,48 @@ we're not looking at the booted deployment. This function is a variant of ostree_sysroot_get_repo() that cannot fail, and -returns a cached repository. Can only be called after ostree_sysroot_load() -has been invoked successfully. - + line="1267">This function is a variant of ostree_sysroot_get_repo() that cannot fail, and +returns a cached repository. Can only be called after ostree_sysroot_initialize() +or ostree_sysroot_load() has been invoked successfully. + The OSTree repository in sysroot @self. + line="1275">The OSTree repository in sysroot @self. Sysroot + line="1269">Sysroot + + + + + + If this function is invoked, then libostree will assume that +a private Linux mount namespace has been created by the process. +The primary use case for this is to have e.g. /sysroot mounted +read-only by default. + +If this function has been called, then when a function which requires +writable access is invoked, libostree will automatically remount as writable +any mount points on which it operates. This currently is just `/sysroot` and +`/boot`. + +If you invoke this function, it must be before ostree_sysroot_load(); it may +be invoked before or after ostree_sysroot_initialize(). + + + + + + @@ -14592,7 +14820,7 @@ has been invoked successfully. throws="1"> Prepend @new_deployment to the list of deployments, commit, and + line="1669">Prepend @new_deployment to the list of deployments, commit, and cleanup. By default, all other deployments for the given @osname except the merge deployment and the booted deployment will be garbage collected. @@ -14614,7 +14842,7 @@ If %OSTREE_SYSROOT_SIMPLE_WRITE_DEPLOYMENT_FLAGS_NO_CLEAN is specified, then no cleanup will be performed after adding the deployment. Make sure to call ostree_sysroot_cleanup() sometime later, instead. - + @@ -14622,7 +14850,7 @@ later, instead. Sysroot + line="1671">Sysroot allow-none="1"> OS name + line="1672">OS name Prepend this deployment to the list + line="1673">Prepend this deployment to the list allow-none="1"> Use this deployment for configuration merge + line="1674">Use this deployment for configuration merge Flags controlling behavior + line="1675">Flags controlling behavior @@ -14662,7 +14890,7 @@ later, instead. allow-none="1"> Cancellable + line="1676">Cancellable @@ -14673,9 +14901,9 @@ later, instead. throws="1"> Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS + line="2842">Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS shutdown time. - + @@ -14683,7 +14911,7 @@ shutdown time. Sysroot + line="2844">Sysroot allow-none="1"> osname to use for merge deployment + line="2845">osname to use for merge deployment Checksum to add + line="2846">Checksum to add allow-none="1"> Origin to use for upgrades + line="2847">Origin to use for upgrades allow-none="1"> Use this deployment for merge path + line="2848">Use this deployment for merge path allow-none="1"> Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment + line="2849">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment @@ -14736,7 +14964,7 @@ shutdown time. transfer-ownership="full"> The new deployment path + line="2850">The new deployment path allow-none="1"> Cancellable + line="2851">Cancellable @@ -14755,14 +14983,14 @@ shutdown time. throws="1"> Try to acquire an exclusive multi-process write lock for @self. If + line="1485">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 (and no error). Release the lock with ostree_sysroot_unlock(). The lock will also be released if @self is deallocated. - + @@ -14770,7 +14998,7 @@ be released if @self is deallocated. Self + line="1487">Self transfer-ownership="full"> Whether or not the lock has been acquired + line="1488">Whether or not the lock has been acquired @@ -14787,13 +15015,13 @@ be released if @self is deallocated. Release any resources such as file descriptors referring to the + line="366">Release any resources such as file descriptors referring to the root directory of this sysroot. Normally, those resources are cleared by finalization, but in garbage collected languages that may not be predictable. This undoes the effect of `ostree_sysroot_load()`. - + @@ -14801,7 +15029,7 @@ This undoes the effect of `ostree_sysroot_load()`. Sysroot + line="368">Sysroot @@ -14809,10 +15037,10 @@ This undoes the effect of `ostree_sysroot_load()`. Clear the lock previously acquired with ostree_sysroot_lock(). It + line="1533">Clear the lock previously acquired with ostree_sysroot_lock(). It is safe to call this function if the lock has not been previously acquired. - + @@ -14820,7 +15048,7 @@ acquired. Self + line="1535">Self @@ -14830,9 +15058,9 @@ acquired. throws="1"> Older version of ostree_sysroot_write_deployments_with_options(). This + line="2113">Older version of ostree_sysroot_write_deployments_with_options(). This version will perform post-deployment cleanup by default. - + @@ -14840,13 +15068,13 @@ version will perform post-deployment cleanup by default. Sysroot + line="2115">Sysroot List of new deployments + line="2116">List of new deployments @@ -14857,7 +15085,7 @@ version will perform post-deployment cleanup by default. allow-none="1"> Cancellable + line="2117">Cancellable @@ -14868,13 +15096,13 @@ version will perform post-deployment cleanup by default. throws="1"> Assuming @new_deployments have already been deployed in place on disk via + line="2239">Assuming @new_deployments have already been deployed in place on disk via ostree_sysroot_deploy_tree(), atomically update bootloader configuration. By default, no post-transaction cleanup will be performed. You should invoke ostree_sysroot_cleanup() at some point after the transaction, or specify `do_postclean` in @opts. Skipping the post-transaction cleanup is useful if for example you want to control pruning of the repository. - + @@ -14882,13 +15110,13 @@ if for example you want to control pruning of the repository. Sysroot + line="2241">Sysroot List of new deployments + line="2242">List of new deployments @@ -14896,7 +15124,7 @@ if for example you want to control pruning of the repository. Options + line="2243">Options @@ -14906,7 +15134,7 @@ if for example you want to control pruning of the repository. allow-none="1"> Cancellable + line="2244">Cancellable @@ -14916,10 +15144,10 @@ if for example you want to control pruning of the repository. throws="1"> Immediately replace the origin file of the referenced @deployment + line="885">Immediately replace the origin file of the referenced @deployment with the contents of @new_origin. If @new_origin is %NULL, this function will write the current origin of @deployment. - + @@ -14927,13 +15155,13 @@ this function will write the current origin of @deployment. System root + line="887">System root Deployment + line="888">Deployment allow-none="1"> Origin content + line="889">Origin content allow-none="1"> Cancellable + line="890">Cancellable @@ -14986,7 +15214,7 @@ Currently, the structured data is only available via the systemd journal. - + @@ -15465,7 +15693,7 @@ from inside the tree such as package databases. - + @@ -15538,7 +15766,7 @@ users who had been using zero before. throws="1"> In many cases using libostree, a program may need to "break" + line="805">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. @@ -15596,19 +15824,19 @@ care of synchronization. Directory fd + line="807">Directory fd Path relative to @dfd + line="808">Path relative to @dfd Do not copy extended attributes + line="809">Do not copy extended attributes - + %TRUE if current libostree has at least the requested version, %FALSE otherwise + line="2707">%TRUE if current libostree has at least the requested version, %FALSE otherwise Major/year required + line="2704">Major/year required Release version required + line="2705">Release version required @@ -15651,7 +15879,7 @@ care of synchronization. Modified base64 encoding of @csum + line="1575">Modified base64 encoding of @csum The "modified" term refers to the fact that instead of '/', the '_' character is used. @@ -15661,7 +15889,7 @@ character is used. An binary checksum of length 32 + line="1573">An binary checksum of length 32 @@ -15673,7 +15901,7 @@ character is used. introspectable="0"> Overwrite the contents of @buf with modified base64 encoding of @csum. + line="1503">Overwrite the contents of @buf with modified base64 encoding of @csum. The "modified" term refers to the fact that instead of '/', the '_' character is used. @@ -15684,7 +15912,7 @@ character is used. An binary checksum of length 32 + line="1505">An binary checksum of length 32 @@ -15692,7 +15920,7 @@ character is used. Output location, must be at least 44 bytes in length + line="1506">Output location, must be at least 44 bytes in length @@ -15702,7 +15930,7 @@ character is used. introspectable="0"> Overwrite the contents of @buf with stringified version of @csum. + line="1384">Overwrite the contents of @buf with stringified version of @csum. @@ -15711,7 +15939,7 @@ character is used. An binary checksum of length 32 + line="1386">An binary checksum of length 32 @@ -15719,7 +15947,7 @@ character is used. Output location, must be at least 45 bytes in length + line="1387">Output location, must be at least 45 bytes in length @@ -15731,7 +15959,7 @@ character is used. Binary version of @checksum. + line="1477">Binary version of @checksum. @@ -15740,7 +15968,7 @@ character is used. An ASCII checksum + line="1475">An ASCII checksum @@ -15751,7 +15979,7 @@ character is used. Binary checksum data in @bytes; do not free. If @bytes does not have the correct length, return %NULL. + line="1594">Binary checksum data in @bytes; do not free. If @bytes does not have the correct length, return %NULL. @@ -15760,7 +15988,7 @@ character is used. #GVariant of type ay + line="1592">#GVariant of type ay @@ -15770,12 +15998,12 @@ character is used. throws="1"> Like ostree_checksum_bytes_peek(), but also throws @error. + line="1607">Like ostree_checksum_bytes_peek(), but also throws @error. Binary checksum data + line="1614">Binary checksum data @@ -15784,7 +16012,7 @@ character is used. #GVariant of type ay + line="1609">#GVariant of type ay @@ -15794,7 +16022,7 @@ character is used. throws="1"> Compute the OSTree checksum for a given file. + line="916">Compute the OSTree checksum for a given file. @@ -15803,13 +16031,13 @@ character is used. File path + line="918">File path Object type + line="919">Object type transfer-ownership="full"> Return location for binary checksum + line="920">Return location for binary checksum @@ -15829,7 +16057,7 @@ character is used. allow-none="1"> Cancellable + line="921">Cancellable @@ -15838,7 +16066,7 @@ character is used. c:identifier="ostree_checksum_file_async"> Asynchronously compute the OSTree checksum for a given file; + line="1075">Asynchronously compute the OSTree checksum for a given file; complete with ostree_checksum_file_async_finish(). @@ -15848,19 +16076,19 @@ complete with ostree_checksum_file_async_finish(). File path + line="1077">File path Object type + line="1078">Object type Priority for operation, see %G_IO_PRIORITY_DEFAULT + line="1079">Priority for operation, see %G_IO_PRIORITY_DEFAULT allow-none="1"> Cancellable + line="1080">Cancellable closure="5"> Invoked when operation is complete + line="1081">Invoked when operation is complete allow-none="1"> Data for @callback + line="1082">Data for @callback @@ -15899,7 +16127,7 @@ complete with ostree_checksum_file_async_finish(). throws="1"> Finish computing the OSTree checksum for a given file; see + line="1109">Finish computing the OSTree checksum for a given file; see ostree_checksum_file_async(). @@ -15909,13 +16137,13 @@ ostree_checksum_file_async(). File path + line="1111">File path Async result + line="1112">Async result transfer-ownership="full"> Return location for binary checksum + line="1113">Return location for binary checksum @@ -15937,7 +16165,7 @@ ostree_checksum_file_async(). throws="1"> Compute the OSTree checksum for a given file. This is an fd-relative version + line="968">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. @@ -15948,13 +16176,13 @@ allocated buffer. Directory file descriptor + line="970">Directory file descriptor Subpath + line="971">Subpath @stbuf (allow-none): Optional stat buffer @@ -15967,13 +16195,13 @@ allocated buffer. Object type + line="973">Object type Flags + line="974">Flags @out_checksum (out) (transfer full): Return location for hex checksum @@ -15986,7 +16214,7 @@ allocated buffer. allow-none="1"> Cancellable + line="976">Cancellable @@ -15996,7 +16224,7 @@ allocated buffer. throws="1"> Compute the OSTree checksum for a given input. + line="862">Compute the OSTree checksum for a given input. @@ -16005,7 +16233,7 @@ allocated buffer. File information + line="864">File information allow-none="1"> Optional extended attributes + line="865">Optional extended attributes allow-none="1"> File content, should be %NULL for symbolic links + line="866">File content, should be %NULL for symbolic links Object type + line="867">Object type transfer-ownership="full"> Return location for binary checksum + line="868">Return location for binary checksum @@ -16049,7 +16277,7 @@ allocated buffer. allow-none="1"> Cancellable + line="869">Cancellable @@ -16060,14 +16288,14 @@ allocated buffer. String form of @csum + line="1549">String form of @csum An binary checksum of length 32 + line="1547">An binary checksum of length 32 @@ -16080,14 +16308,14 @@ allocated buffer. String form of @csum_bytes + line="1563">String form of @csum_bytes #GVariant of type ay + line="1561">#GVariant of type ay @@ -16097,7 +16325,7 @@ allocated buffer. introspectable="0"> Overwrite the contents of @buf with stringified version of @csum. + line="1489">Overwrite the contents of @buf with stringified version of @csum. @@ -16106,7 +16334,7 @@ allocated buffer. An binary checksum of length 32 + line="1491">An binary checksum of length 32 @@ -16114,7 +16342,7 @@ allocated buffer. Output location, must be at least OSTREE_SHA256_STRING_LEN+1 bytes in length + line="1492">Output location, must be at least OSTREE_SHA256_STRING_LEN+1 bytes in length @@ -16123,7 +16351,7 @@ allocated buffer. c:identifier="ostree_checksum_inplace_to_bytes"> Convert @checksum from a string to binary in-place, without + line="1413">Convert @checksum from a string to binary in-place, without allocating memory. Use this function in hot code paths. @@ -16133,13 +16361,13 @@ allocating memory. Use this function in hot code paths. a SHA256 string + line="1415">a SHA256 string Output buffer with at least 32 bytes of space + line="1416">Output buffer with at least 32 bytes of space @@ -16149,7 +16377,7 @@ allocating memory. Use this function in hot code paths. Binary checksum from @checksum of length 32; free with g_free(). + line="1449">Binary checksum from @checksum of length 32; free with g_free(). @@ -16158,7 +16386,7 @@ allocating memory. Use this function in hot code paths. An ASCII checksum + line="1447">An ASCII checksum @@ -16169,14 +16397,14 @@ allocating memory. Use this function in hot code paths. New #GVariant of type ay with length 32 + line="1463">New #GVariant of type ay with length 32 An ASCII checksum + line="1461">An ASCII checksum @@ -16191,7 +16419,7 @@ allocating memory. Use this function in hot code paths. c:identifier="ostree_cmp_checksum_bytes"> Compare two binary checksums, using memcmp(). + line="1335">Compare two binary checksums, using memcmp(). @@ -16200,13 +16428,13 @@ allocating memory. Use this function in hot code paths. A binary checksum + line="1337">A binary checksum A binary checksum + line="1338">A binary checksum @@ -16322,7 +16550,7 @@ must be %NULL-terminated; it may be empty, but must not be %NULL. version="2018.2"> There are use cases where one wants a checksum just of the content of a + line="2388">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 often results in a new checksum. @@ -16337,24 +16565,62 @@ root "dirmeta" checksum (both in binary form, not hexadecimal). A SHA-256 hex string, or %NULL if @commit_variant is not well-formed + line="2404">A SHA-256 hex string, or %NULL if @commit_variant is not well-formed A commit object + line="2390">A commit object + + Reads a commit's "ostree.sizes" metadata and returns an array of +#OstreeCommitSizesEntry in @out_sizes_entries. Each element +represents an object in the commit. If the commit does not contain +the "ostree.sizes" metadata, a %G_IO_ERROR_NOT_FOUND error will be +returned. + + + + + + + variant of type %OSTREE_OBJECT_TYPE_COMMIT + + + + + return location for an array of object size entries + + + + + + Checksum of the parent commit of @commit_variant, or %NULL + line="2366">Checksum of the parent commit of @commit_variant, or %NULL if none @@ -16362,7 +16628,7 @@ if none Variant of type %OSTREE_OBJECT_TYPE_COMMIT + line="2364">Variant of type %OSTREE_OBJECT_TYPE_COMMIT @@ -16384,7 +16650,7 @@ if none throws="1"> A thin wrapper for ostree_content_stream_parse(); this function + line="730">A thin wrapper for ostree_content_stream_parse(); this function converts an object content stream back into components. @@ -16394,19 +16660,19 @@ converts an object content stream back into components. Whether or not the stream is zlib-compressed + line="732">Whether or not the stream is zlib-compressed Path to file containing content + line="733">Path to file containing content If %TRUE, assume the content has been validated + line="734">If %TRUE, assume the content has been validated transfer-ownership="full"> The raw file content stream + line="735">The raw file content stream transfer-ownership="full"> Normal metadata + line="736">Normal metadata transfer-ownership="full"> Extended attributes + line="737">Extended attributes allow-none="1"> Cancellable + line="738">Cancellable @@ -16452,7 +16718,7 @@ converts an object content stream back into components. throws="1"> A thin wrapper for ostree_content_stream_parse(); this function + line="679">A thin wrapper for ostree_content_stream_parse(); this function converts an object content stream back into components. @@ -16462,25 +16728,25 @@ converts an object content stream back into components. Whether or not the stream is zlib-compressed + line="681">Whether or not the stream is zlib-compressed Directory file descriptor + line="682">Directory file descriptor Subpath + line="683">Subpath If %TRUE, assume the content has been validated + line="684">If %TRUE, assume the content has been validated transfer-ownership="full"> The raw file content stream + line="685">The raw file content stream transfer-ownership="full"> Normal metadata + line="686">Normal metadata transfer-ownership="full"> Extended attributes + line="687">Extended attributes allow-none="1"> Cancellable + line="688">Cancellable @@ -16526,7 +16792,7 @@ converts an object content stream back into components. throws="1"> The reverse of ostree_raw_file_to_content_stream(); this function + line="580">The reverse of ostree_raw_file_to_content_stream(); this function converts an object content stream back into components. @@ -16536,25 +16802,25 @@ converts an object content stream back into components. Whether or not the stream is zlib-compressed + line="582">Whether or not the stream is zlib-compressed Object content stream + line="583">Object content stream Length of stream + line="584">Length of stream If %TRUE, assume the content has been validated + line="585">If %TRUE, assume the content has been validated transfer-ownership="full"> The raw file content stream + line="586">The raw file content stream transfer-ownership="full"> Normal metadata + line="587">Normal metadata transfer-ownership="full"> Extended attributes + line="588">Extended attributes allow-none="1"> Cancellable + line="589">Cancellable @@ -16601,14 +16867,14 @@ converts an object content stream back into components. A new #GVariant containing %OSTREE_OBJECT_TYPE_DIR_META + line="1161">A new #GVariant containing %OSTREE_OBJECT_TYPE_DIR_META a #GFileInfo containing directory information + line="1158">a #GFileInfo containing directory information allow-none="1"> Optional extended attributes + line="1159">Optional extended attributes @@ -16817,7 +17083,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added. Use this function with #GHashTable and ostree_object_name_serialize(). + line="1316">Use this function with #GHashTable and ostree_object_name_serialize(). @@ -16829,7 +17095,7 @@ sets of #OstreeDiffItem in @modified, @removed, and @added. allow-none="1"> A #GVariant containing a serialized object + line="1318">A #GVariant containing a serialized object @@ -16914,7 +17180,7 @@ to the empty OstreeKernelArgs c:identifier="ostree_object_from_string"> Reverse ostree_object_to_string(). + line="1295">Reverse ostree_object_to_string(). @@ -16923,7 +17189,7 @@ to the empty OstreeKernelArgs An ASCII checksum + line="1297">An ASCII checksum transfer-ownership="full"> Parsed checksum + line="1298">Parsed checksum transfer-ownership="full"> Parsed object type + line="1299">Parsed object type @@ -16950,7 +17216,7 @@ to the empty OstreeKernelArgs c:identifier="ostree_object_name_deserialize"> Reverse ostree_object_name_serialize(). Note that @out_checksum is + line="1365">Reverse ostree_object_name_serialize(). Note that @out_checksum is only valid for the lifetime of @variant, and must not be freed. @@ -16960,7 +17226,7 @@ only valid for the lifetime of @variant, and must not be freed. A #GVariant of type (su) + line="1367">A #GVariant of type (su) transfer-ownership="none"> Pointer into string memory of @variant with checksum + line="1368">Pointer into string memory of @variant with checksum transfer-ownership="full"> Return object type + line="1369">Return object type @@ -16989,20 +17255,20 @@ only valid for the lifetime of @variant, and must not be freed. A new floating #GVariant containing checksum string and objtype + line="1354">A new floating #GVariant containing checksum string and objtype An ASCII checksum + line="1351">An ASCII checksum An object type + line="1352">An object type @@ -17012,20 +17278,20 @@ only valid for the lifetime of @variant, and must not be freed. A string containing both @checksum and a stringifed version of @objtype + line="1286">A string containing both @checksum and a stringifed version of @objtype An ASCII checksum + line="1283">An ASCII checksum Object type + line="1284">Object type @@ -17034,7 +17300,7 @@ only valid for the lifetime of @variant, and must not be freed. c:identifier="ostree_object_type_from_string"> The reverse of ostree_object_type_to_string(). + line="1254">The reverse of ostree_object_type_to_string(). @@ -17043,7 +17309,7 @@ only valid for the lifetime of @variant, and must not be freed. A stringified version of #OstreeObjectType + line="1256">A stringified version of #OstreeObjectType @@ -17052,7 +17318,7 @@ only valid for the lifetime of @variant, and must not be freed. c:identifier="ostree_object_type_to_string"> Serialize @objtype to a string; this is used for file extensions. + line="1223">Serialize @objtype to a string; this is used for file extensions. @@ -17061,7 +17327,7 @@ only valid for the lifetime of @variant, and must not be freed. an #OstreeObjectType + line="1225">an #OstreeObjectType @@ -17071,7 +17337,7 @@ only valid for the lifetime of @variant, and must not be freed. throws="1"> Split a refspec like `gnome-ostree:gnome-ostree/buildmaster` or just + line="155">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 @@ -17080,14 +17346,14 @@ will be `gnome-ostree/buildmaster`. In both cases, %TRUE will be returned. %TRUE on successful parsing, %FALSE otherwise + line="169">%TRUE on successful parsing, %FALSE otherwise A "refspec" string + line="157">A "refspec" string allow-none="1"> Return location for the remote name, + line="158">Return location for the remote name, or %NULL if the refspec refs to a local ref @@ -17111,7 +17377,7 @@ will be `gnome-ostree/buildmaster`. In both cases, %TRUE will be returned. allow-none="1"> Return location for the ref name + line="160">Return location for the ref name @@ -17122,7 +17388,7 @@ will be `gnome-ostree/buildmaster`. In both cases, %TRUE will be returned. throws="1"> Convert from a "bare" file representation into an + line="478">Convert from a "bare" file representation into an OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull. @@ -17132,13 +17398,13 @@ OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull. File raw content stream + line="480">File raw content stream A file info + line="481">A file info allow-none="1"> Optional extended attributes + line="482">Optional extended attributes transfer-ownership="full"> Serialized object stream + line="483">Serialized object stream allow-none="1"> Cancellable + line="484">Cancellable @@ -17176,7 +17442,7 @@ OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull. throws="1"> Like ostree_raw_file_to_archive_z2_stream(), but supports an extensible set + line="505">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 @@ -17189,13 +17455,13 @@ of flags. The following flags are currently defined: File raw content stream + line="507">File raw content stream A file info + line="508">A file info Optional extended attributes + line="509">Optional extended attributes A GVariant `a{sv}` with an extensible set of flags + line="510">A GVariant `a{sv}` with an extensible set of flags Serialized object stream + line="511">Serialized object stream Cancellable + line="512">Cancellable @@ -17241,7 +17507,7 @@ of flags. The following flags are currently defined: throws="1"> Convert from a "bare" file representation into an + line="545">Convert from a "bare" file representation into an OSTREE_OBJECT_TYPE_FILE stream. This is a fundamental operation for writing data to an #OstreeRepo. @@ -17252,13 +17518,13 @@ for writing data to an #OstreeRepo. File raw content stream + line="547">File raw content stream A file info + line="548">A file info allow-none="1"> Optional extended attributes + line="549">Optional extended attributes transfer-ownership="full"> Serialized object stream + line="550">Serialized object stream transfer-ownership="full"> Length of stream + line="551">Length of stream allow-none="1"> Cancellable + line="552">Cancellable @@ -17436,19 +17702,19 @@ for writing data to an #OstreeRepo. throws="1"> Use this function to see if input strings are checksums. + line="132">Use this function to see if input strings are checksums. %TRUE if @sha256 is a valid checksum string, %FALSE otherwise + line="139">%TRUE if @sha256 is a valid checksum string, %FALSE otherwise SHA256 hex string + line="134">SHA256 hex string @@ -17459,7 +17725,7 @@ for writing data to an #OstreeRepo. throws="1"> Check whether the given @collection_id is valid. Return an error if it is + line="285">Check whether the given @collection_id is valid. Return an error if it is invalid or %NULL. Valid collection IDs are reverse DNS names: @@ -17476,7 +17742,7 @@ Valid collection IDs are reverse DNS names: %TRUE if @collection_id is a valid collection ID, %FALSE if it is invalid + line="304">%TRUE if @collection_id is a valid collection ID, %FALSE if it is invalid or %NULL @@ -17487,7 +17753,7 @@ Valid collection IDs are reverse DNS names: allow-none="1"> A collection ID + line="287">A collection ID @@ -17500,14 +17766,14 @@ Valid collection IDs are reverse DNS names: %TRUE if @remote_name is a valid remote name + line="261">%TRUE if @remote_name is a valid remote name A remote name + line="258">A remote name @@ -17519,14 +17785,14 @@ Valid collection IDs are reverse DNS names: %TRUE if @rev is a valid ref string + line="233">%TRUE if @rev is a valid ref string A revision string + line="230">A revision string @@ -17538,14 +17804,14 @@ Valid collection IDs are reverse DNS names: %TRUE if @checksum is a valid ASCII SHA256 checksum + line="2058">%TRUE if @checksum is a valid ASCII SHA256 checksum an ASCII string + line="2055">an ASCII string @@ -17555,20 +17821,20 @@ Valid collection IDs are reverse DNS names: throws="1"> Use this to validate the basic structure of @commit, independent of + line="2180">Use this to validate the basic structure of @commit, independent of any other objects it references. %TRUE if @commit is structurally valid + line="2188">%TRUE if @commit is structurally valid A commit object, %OSTREE_OBJECT_TYPE_COMMIT + line="2182">A commit object, %OSTREE_OBJECT_TYPE_COMMIT @@ -17580,14 +17846,14 @@ any other objects it references. %TRUE if @checksum is a valid binary SHA256 checksum + line="2044">%TRUE if @checksum is a valid binary SHA256 checksum a #GVariant of type "ay" + line="2041">a #GVariant of type "ay" @@ -17597,19 +17863,19 @@ any other objects it references. throws="1"> Use this to validate the basic structure of @dirmeta. + line="2332">Use this to validate the basic structure of @dirmeta. %TRUE if @dirmeta is structurally valid + line="2339">%TRUE if @dirmeta is structurally valid A dirmeta object, %OSTREE_OBJECT_TYPE_DIR_META + line="2334">A dirmeta object, %OSTREE_OBJECT_TYPE_DIR_META @@ -17619,20 +17885,20 @@ any other objects it references. throws="1"> Use this to validate the basic structure of @dirtree, independent of + line="2220">Use this to validate the basic structure of @dirtree, independent of any other objects it references. %TRUE if @dirtree is structurally valid + line="2228">%TRUE if @dirtree is structurally valid A dirtree object, %OSTREE_OBJECT_TYPE_DIR_TREE + line="2222">A dirtree object, %OSTREE_OBJECT_TYPE_DIR_TREE @@ -17644,14 +17910,14 @@ any other objects it references. %TRUE if @mode represents a valid file type and permissions + line="2317">%TRUE if @mode represents a valid file type and permissions A Unix filesystem mode + line="2314">A Unix filesystem mode @@ -17663,7 +17929,7 @@ any other objects it references. %TRUE if @objtype represents a valid object type + line="2026">%TRUE if @objtype represents a valid object type