diff --git a/rust-bindings/rust/gir-files/OSTree-1.0.gir b/rust-bindings/rust/gir-files/OSTree-1.0.gir index 4dd5387c..424ec2d7 100644 --- a/rust-bindings/rust/gir-files/OSTree-1.0.gir +++ b/rust-bindings/rust/gir-files/OSTree-1.0.gir @@ -1542,38 +1542,38 @@ entry corresponds to an object in the associated commit. version="2020.1"> Create a new #OstreeCommitSizesEntry for representing an object in a + line="2464">Create a new #OstreeCommitSizesEntry for representing an object in a commit's "ostree.sizes" metadata. a new #OstreeCommitSizesEntry + line="2474">a new #OstreeCommitSizesEntry object checksum + line="2466">object checksum object type + line="2467">object type unpacked object size + line="2468">unpacked object size compressed object size + line="2469">compressed object size @@ -1583,19 +1583,19 @@ commit's "ostree.sizes" metadata. version="2020.1"> Create a copy of the given @entry. + line="2494">Create a copy of the given @entry. a new copy of @entry + line="2500">a new copy of @entry an #OstreeCommitSizesEntry + line="2496">an #OstreeCommitSizesEntry @@ -1606,7 +1606,7 @@ commit's "ostree.sizes" metadata. version="2020.1"> Free given @entry. + line="2514">Free given @entry. @@ -1615,7 +1615,7 @@ commit's "ostree.sizes" metadata. an #OstreeCommitSizesEntry + line="2516">an #OstreeCommitSizesEntry @@ -1645,49 +1645,59 @@ commit's "ostree.sizes" metadata. + New deployment + Global index into the bootloader entries + "stateroot" for this deployment + OSTree commit that will be deployed + Unique counter - + + Kernel/initrd checksum + Unique index - - - - - - - - - - - The intention of an origin file is primarily describe the "inputs" that + line="183">The intention of an origin file is primarily describe the "inputs" that resulted in a deployment, and it's commonly used to derive the new state. For example, a key value (in pure libostree mode) is the "refspec". However, libostree (or other applications) may want to store "transient" state that @@ -1709,7 +1719,7 @@ that should have been under an explicit group. An origin + line="185">An origin @@ -1719,6 +1729,9 @@ that should have been under an explicit group. version="2016.4"> + Description of state @@ -1733,14 +1746,14 @@ that should have been under an explicit group. New deep copy of @self + line="252">New deep copy of @self Deployment + line="250">Deployment @@ -1750,20 +1763,20 @@ that should have been under an explicit group. %TRUE if deployments have the same osname, csum, and deployserial + line="306">%TRUE if deployments have the same osname, csum, and deployserial A deployment + line="303">A deployment A deployment + line="304">A deployment @@ -1774,14 +1787,14 @@ that should have been under an explicit group. Boot configuration + line="94">Boot configuration Deployment + line="92">Deployment @@ -1836,10 +1849,16 @@ that should have been under an explicit group. + The global index into the bootloader ordering + Deployment @@ -1849,14 +1868,14 @@ that should have been under an explicit group. Origin + line="106">Origin Deployment + line="104">Deployment @@ -1865,21 +1884,21 @@ that should have been under an explicit group. c:identifier="ostree_deployment_get_origin_relpath"> Note this function only returns a *relative* path - if you want to + line="394">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="402">Path to deployment root directory, relative to sysroot A deployment + line="396">A deployment @@ -1909,24 +1928,41 @@ or concatenate it with the full ostree_sysroot_get_path(). + + + + An integer suitable for use in a `GHashTable` + + + + + Deployment + + + + See ostree_sysroot_deployment_set_pinned(). + line="447">See ostree_sysroot_deployment_set_pinned(). `TRUE` if deployment will not be subject to GC + line="453">`TRUE` if deployment will not be subject to GC Deployment + line="449">Deployment @@ -1938,72 +1974,115 @@ or concatenate it with the full ostree_sysroot_get_path(). `TRUE` if deployment should be "finalized" at shutdown time + line="468">`TRUE` if deployment should be "finalized" at shutdown time Deployment + line="466">Deployment + Set or clear the bootloader configuration. + Deployment - + + Bootloader configuration object + Should never have been made public API; don't use this. + Deployment + Don't use this + Sets the global index into the bootloader ordering. + Deployment + Index into bootloader ordering + Replace the "origin", which is a description of the source +of the deployment and how to update to the next version. + Deployment - + + Set the origin for this deployment @@ -2077,7 +2156,7 @@ ostree_diff_dirs_with_options(). c:symbol-prefix="diff_item"> - + @@ -3656,13 +3735,33 @@ exhaustion attacks. + + GVariant type `b`: Set if this commit is intended to be bootable + + + + + GVariant type `s`: Contains the Linux kernel release (i.e. `uname -r`) + + + GVariant type `s`. This key can be used in the repo metadata which is stored + line="1492">GVariant type `s`. This key can be used in the repo metadata which is stored in OSTREE_REPO_METADATA_REF as well as in the summary. The semantics of this are that the remote repository wants clients to update their remote config to add this collection ID (clients can't do P2P operations involving a @@ -3677,7 +3776,7 @@ Flatpak may implement it. This is a replacement for the similar metadata key implemented by flatpak, `xa.collection-id`, which is now deprecated as clients which supported it had bugs with their P2P implementations. - + version="2018.6"> The name of a ref which is used to store metadata for the entire repository, + line="1469">The name of a ref which is used to store metadata for the entire repository, such as its expected update time (`ostree.summary.expires`), name, or new GPG keys. Metadata is stored on contentless commits in the ref, and hence is signed with the commits. @@ -4309,7 +4408,7 @@ collection ID (ostree_repo_set_collection_id()). Users of OSTree may place arbitrary metadata in commits on this ref, but the keys must be namespaced by product or developer. For example, `exampleos.end-of-life`. The `ostree.` prefix is reserved. - + An accessor object for an OSTree repository located at @path + line="1243">An accessor object for an OSTree repository located at @path Path to a repository + line="1241">Path to a repository @@ -4435,7 +4534,7 @@ reference count reaches 0. If the current working directory appears to be an OSTree + line="1316">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 @@ -4444,7 +4543,7 @@ Otherwise use the path in the OSTREE_REPO environment variable An accessor object for an OSTree repository located at /ostree/repo + line="1325">An accessor object for an OSTree repository located at /ostree/repo @@ -4452,26 +4551,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="1299">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="1307">An accessor object for the OSTree repository located at @repo_path. Path to a repository + line="1301">Path to a repository Path to the system root + line="1302">Path to the system root @@ -4482,7 +4581,7 @@ instead of assuming "/". throws="1"> This is a file-descriptor relative version of ostree_repo_create(). + line="2582">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. @@ -4498,32 +4597,35 @@ The @options dict may contain: A new OSTree repository reference + line="2604">A new OSTree repository reference Directory fd + line="2584">Directory fd Path + line="2585">Path The mode to store the repository in + line="2586">The mode to store the repository in - + a{sv}: See below for accepted keys + line="2587">a{sv}: See below for accepted keys Cancellable + line="2588">Cancellable @@ -4548,7 +4650,7 @@ The @options dict may contain: a repo mode as a string + line="2408">a repo mode as a string the corresponding #OstreeRepoMode + line="2409">the corresponding #OstreeRepoMode @@ -4568,27 +4670,27 @@ The @options dict may contain: throws="1"> This combines ostree_repo_new() (but using fd-relative access) with + line="1264">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="1273">An accessor object for an OSTree repository located at @dfd + @path Directory fd + line="1266">Directory fd Path + line="1267">Path Convenient "changed" callback for use with + line="4763">Convenient "changed" callback for use with ostree_async_progress_new_and_connect() when pulling from a remote repository. @@ -4615,7 +4717,7 @@ number of objects. Compatibility note: this function previously assumed that @user_data was a pointer to a #GSConsole instance. This is no longer the case, and @user_data is ignored. - + @@ -4623,7 +4725,7 @@ and @user_data is ignored. Async progress + line="4765">Async progress allow-none="1"> User data + line="4766">User data @@ -4645,7 +4747,7 @@ and @user_data is ignored. line="297">This hash table is a mapping from #GVariant which can be accessed via ostree_object_name_deserialize() to a #GVariant containing either a similar #GVariant or and array of them, listing the parents of the key. - + filename="ostree-repo-traverse.c" line="282">This hash table is a set of #GVariant which can be accessed via ostree_object_name_deserialize(). - + filename="ostree-repo-traverse.c" line="348">Gets all the commits that a certain object belongs to, as recorded by a parents table gotten from ostree_repo_traverse_commit_union_with_parents. - + throws="1"> Abort the active transaction; any staged objects and ref changes will be + line="2355">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. @@ -4719,7 +4821,7 @@ transaction will do nothing and return successfully. An #OstreeRepo + line="2357">An #OstreeRepo allow-none="1"> Cancellable + line="2358">Cancellable @@ -4738,8 +4840,8 @@ transaction will do nothing and return successfully. throws="1"> Add a GPG signature to a summary file. - + line="5134">Add a GPG signature to a summary file. + @@ -4747,13 +4849,13 @@ transaction will do nothing and return successfully. Self + line="5136">Self NULL-terminated array of GPG keys. + line="5137">NULL-terminated array of GPG keys. @@ -4764,7 +4866,7 @@ transaction will do nothing and return successfully. allow-none="1"> GPG home directory, or %NULL + line="5138">GPG home directory, or %NULL allow-none="1"> A #GCancellable + line="5139">A #GCancellable @@ -4783,8 +4885,8 @@ transaction will do nothing and return successfully. throws="1"> Append a GPG signature to a commit. - + line="4913">Append a GPG signature to a commit. + @@ -4792,19 +4894,19 @@ transaction will do nothing and return successfully. Self + line="4915">Self SHA256 of given commit to sign + line="4916">SHA256 of given commit to sign Signature data + line="4917">Signature data allow-none="1"> A #GCancellable + line="4918">A #GCancellable @@ -5048,7 +5150,7 @@ This function is deprecated. Use ostree_repo_checkout_at() instead. throws="1"> Complete the transaction. Any refs set with + line="2259">Complete the transaction. Any refs set with ostree_repo_transaction_set_ref() or ostree_repo_transaction_set_refspec() will be written out. @@ -5066,7 +5168,7 @@ active at a time. An #OstreeRepo + line="2261">An #OstreeRepo allow-none="1"> A set of statistics of things + line="2262">A set of statistics of things that happened during this transaction. @@ -5088,7 +5190,7 @@ that happened during this transaction. allow-none="1"> Cancellable + line="2264">Cancellable @@ -5098,7 +5200,7 @@ that happened during this transaction. A newly-allocated copy of the repository config + line="1444">A newly-allocated copy of the repository config @@ -5110,7 +5212,7 @@ that happened during this transaction. Create the underlying structure on disk for the repository, and call + line="2534">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 @@ -5132,13 +5234,13 @@ this function on a repository initialized via ostree_repo_open_at(). An #OstreeRepo + line="2536">An #OstreeRepo The mode to store the repository in + line="2537">The mode to store the repository in allow-none="1"> Cancellable + line="2538">Cancellable @@ -5157,7 +5259,7 @@ this function on a repository initialized via ostree_repo_open_at(). throws="1"> Remove the object of type @objtype with checksum @sha256 + line="4208">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. @@ -5168,19 +5270,19 @@ is thrown if the object does not exist. Repo + line="4210">Repo Object type + line="4211">Object type Checksum + line="4212">Checksum allow-none="1"> Cancellable + line="4213">Cancellable @@ -5197,27 +5299,27 @@ is thrown if the object does not exist. Check whether two opened repositories are the same on disk: if their root + line="3482">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="3491">%TRUE if @a and @b are the same repository on disk, %FALSE otherwise an #OstreeRepo + line="3484">an #OstreeRepo an #OstreeRepo + line="3485">an #OstreeRepo @@ -5228,7 +5330,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="1254">Import an archive file @archive into the repository, and write its file structure to @mtree. @@ -5238,20 +5340,20 @@ file structure to @mtree. An #OstreeRepo + line="1256">An #OstreeRepo Options controlling conversion + line="1257">Options controlling conversion An #OstreeRepoFile for the base directory + line="1258">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="1259">A `struct archive`, but specified as void to avoid a dependency on the libarchive headers allow-none="1"> Cancellable + line="1260">Cancellable @@ -5279,7 +5381,7 @@ file structure to @mtree. version="2018.6"> Find reachable remote URIs which claim to provide any of the given named + line="5408">Find reachable remote URIs which claim to provide any of the given named @refs. This will search for configured remotes (#OstreeRepoFinderConfig), mounted volumes (#OstreeRepoFinderMount) and (if enabled at compile time) local network peers (#OstreeRepoFinderAvahi). In order to use a custom @@ -5319,7 +5421,7 @@ this is not guaranteed). GPG verification of commits will be used unconditionally. This will use the thread-default #GMainContext, but will not iterate it. - + @@ -5327,13 +5429,13 @@ This will use the thread-default #GMainContext, but will not iterate it. an #OstreeRepo + line="5410">an #OstreeRepo non-empty array of collection–ref pairs to find remotes for + line="5411">non-empty array of collection–ref pairs to find remotes for @@ -5344,13 +5446,13 @@ This will use the thread-default #GMainContext, but will not iterate it. allow-none="1"> a GVariant `a{sv}` with an extensible set of flags + line="5412">a GVariant `a{sv}` with an extensible set of flags non-empty array of + line="5413">non-empty array of #OstreeRepoFinder instances to use, or %NULL to use the system defaults @@ -5362,7 +5464,7 @@ This will use the thread-default #GMainContext, but will not iterate it. allow-none="1"> an #OstreeAsyncProgress to update with the operation’s + line="5415">an #OstreeAsyncProgress to update with the operation’s progress, or %NULL @@ -5372,7 +5474,7 @@ This will use the thread-default #GMainContext, but will not iterate it. allow-none="1"> a #GCancellable, or %NULL + line="5417">a #GCancellable, or %NULL closure="6"> asynchronous completion callback + line="5418">asynchronous completion callback allow-none="1"> data to pass to @callback + line="5419">data to pass to @callback @@ -5403,13 +5505,13 @@ This will use the thread-default #GMainContext, but will not iterate it. throws="1"> Finish an asynchronous pull operation started with + line="6207">Finish an asynchronous pull operation started with ostree_repo_find_remotes_async(). - + a potentially empty array + line="6216">a potentially empty array of #OstreeRepoFinderResults, followed by a %NULL terminator element; or %NULL on error @@ -5420,13 +5522,13 @@ ostree_repo_find_remotes_async(). an #OstreeRepo + line="6209">an #OstreeRepo the asynchronous result + line="6210">the asynchronous result @@ -5437,7 +5539,7 @@ ostree_repo_find_remotes_async(). throws="1"> Verify consistency of the object; this performs checks only relevant to the + line="4324">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. @@ -5448,19 +5550,19 @@ traverse metadata objects for example. Repo + line="4326">Repo Object type + line="4327">Object type Checksum + line="4328">Checksum allow-none="1"> Cancellable + line="4329">Cancellable @@ -5479,20 +5581,20 @@ traverse metadata objects for example. version="2019.2"> Get the bootloader configured. See the documentation for the + line="6293">Get the bootloader configured. See the documentation for the "sysroot.bootloader" config key. bootloader configuration for the sysroot + line="6300">bootloader configuration for the sysroot an #OstreeRepo + line="6295">an #OstreeRepo @@ -5502,19 +5604,19 @@ traverse metadata objects for example. version="2018.6"> Get the collection ID of this repository. See [collection IDs][collection-ids]. + line="6221">Get the collection ID of this repository. See [collection IDs][collection-ids]. collection ID for the repository + line="6227">collection ID for the repository an #OstreeRepo + line="6223">an #OstreeRepo @@ -5524,7 +5626,7 @@ traverse metadata objects for example. The repository configuration; do not modify + line="1430">The repository configuration; do not modify @@ -5538,13 +5640,13 @@ traverse metadata objects for example. version="2018.9"> Get the set of default repo finders configured. See the documentation for + line="6274">Get the set of default repo finders configured. See the documentation for the "core.default-repo-finders" config key. + line="6281"> %NULL-terminated array of strings. @@ -5554,7 +5656,7 @@ the "core.default-repo-finders" config key. an #OstreeRepo + line="6276">an #OstreeRepo @@ -5564,7 +5666,7 @@ the "core.default-repo-finders" config key. version="2016.4"> In some cases it's useful for applications to access the repository + line="3433">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). @@ -5572,14 +5674,14 @@ repository (to see whether a ref was written). File descriptor for repository root - owned by @self + line="3442">File descriptor for repository root - owned by @self Repo + line="3435">Repo @@ -5588,19 +5690,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="3380">For more information see ostree_repo_set_disable_fsync(). Whether or not fsync() is enabled for this repo. + line="3386">Whether or not fsync() is enabled for this repo. An #OstreeRepo + line="3382">An #OstreeRepo @@ -5611,7 +5713,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="3515">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. @@ -5619,14 +5721,14 @@ core.min-free-space-percent repo config options. %TRUE on success, %FALSE otherwise. + line="3526">%TRUE on success, %FALSE otherwise. Repo + line="3517">Repo transfer-ownership="full"> Location to store the result + line="3518">Location to store the result @@ -5654,20 +5756,20 @@ core.min-free-space-percent repo config options. Before this function can be used, ostree_repo_init() must have been + line="3542">Before this function can be used, ostree_repo_init() must have been called. Parent repository, or %NULL if none + line="3549">Parent repository, or %NULL if none Repo + line="3544">Repo @@ -5675,21 +5777,21 @@ called. Note that since the introduction of ostree_repo_open_at(), this function may + line="3411">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="3419">Path to repo Repo + line="3413">Repo @@ -5856,29 +5958,104 @@ option name. If an error is returned, @out_value will be set to %NULL. + + Sign the given @data with the specified keys in @key_id. Similar to +ostree_repo_add_gpg_signature_summary() but can be used on any +data. + +You can use ostree_repo_gpg_verify_data() to verify the signatures. + + + @TRUE if @data has been signed successfully, +@FALSE in case of error (@error will contain the reason). + + + + + Self + + + + Data as a #GBytes + + + + Existing signatures to append to (or %NULL) + + + + NULL-terminated array of GPG keys. + + + + + + GPG home directory, or %NULL + + + + in case of success will contain signature + + + + A #GCancellable + + + + Verify @signatures for @data using GPG keys in the keyring for + line="5607">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 the verifications using GPG keys in the keyrings of all remotes. - + an #OstreeGpgVerifyResult, or %NULL on error + line="5624">an #OstreeGpgVerifyResult, or %NULL on error Repository + line="5609">Repository allow-none="1"> Name of remote + line="5610">Name of remote Data as a #GBytes + line="5611">Data as a #GBytes Signatures as a #GBytes + line="5612">Signatures as a #GBytes allow-none="1"> Path to directory GPG keyrings; overrides built-in default if given + line="5613">Path to directory GPG keyrings; overrides built-in default if given allow-none="1"> Path to additional keyring file (not a directory) + line="5614">Path to additional keyring file (not a directory) allow-none="1"> Cancellable + line="5615">Cancellable @@ -5936,32 +6113,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="4166">Set @out_have_object to %TRUE if @self contains the given object; %FALSE otherwise. %FALSE if an unexpected error occurred, %TRUE otherwise + line="4178">%FALSE if an unexpected error occurred, %TRUE otherwise Repo + line="4168">Repo Object type + line="4169">Object type ASCII SHA256 checksum + line="4170">ASCII SHA256 checksum transfer-ownership="full"> %TRUE if repository contains object + line="4171">%TRUE if repository contains object allow-none="1"> Cancellable + line="4172">Cancellable @@ -5987,7 +6164,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="3452">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. @@ -5997,14 +6174,14 @@ This function does no I/O. hash value for the #OstreeRepo + line="3463">hash value for the #OstreeRepo an #OstreeRepo + line="3454">an #OstreeRepo @@ -6015,7 +6192,7 @@ This function does no I/O. throws="1"> Import an archive file @archive into the repository, and write its + line="840">Import an archive file @archive into the repository, and write its file structure to @mtree. @@ -6025,13 +6202,13 @@ file structure to @mtree. An #OstreeRepo + line="842">An #OstreeRepo Options structure, ensure this is zeroed, then set specific variables + line="843">Options structure, ensure this is zeroed, then set specific variables @@ -6041,13 +6218,13 @@ file structure to @mtree. allow-none="1"> Really this is "struct archive*" + line="844">Really this is "struct archive*" The #OstreeMutableTree to write to + line="845">The #OstreeMutableTree to write to allow-none="1"> Optional commit modifier + line="846">Optional commit modifier @@ -6066,7 +6243,7 @@ file structure to @mtree. allow-none="1"> Cancellable + line="847">Cancellable @@ -6076,7 +6253,7 @@ file structure to @mtree. throws="1"> Copy object named by @objtype and @checksum into @self from the + line="4351">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. @@ -6090,25 +6267,25 @@ Otherwise, a copy will be performed. Destination repo + line="4353">Destination repo Source repo + line="4354">Source repo Object type + line="4355">Object type checksum + line="4356">checksum allow-none="1"> Cancellable + line="4357">Cancellable @@ -6128,7 +6305,7 @@ Otherwise, a copy will be performed. throws="1"> Copy object named by @objtype and @checksum into @self from the + line="4380">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. @@ -6142,31 +6319,31 @@ Otherwise, a copy will be performed. Destination repo + line="4382">Destination repo Source repo + line="4383">Source repo Object type + line="4384">Object type checksum + line="4385">checksum If %TRUE, assume the source repo is valid and trusted + line="4386">If %TRUE, assume the source repo is valid and trusted allow-none="1"> Cancellable + line="4387">Cancellable @@ -6185,14 +6362,14 @@ Otherwise, a copy will be performed. %TRUE if this repository is the root-owned system global repository + line="1354">%TRUE if this repository is the root-owned system global repository Repository + line="1352">Repository @@ -6202,20 +6379,20 @@ Otherwise, a copy will be performed. throws="1"> Returns whether the repository is writable by the current user. + line="1384">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="1392">%TRUE if this repository is writable Repo + line="1386">Repo @@ -6240,7 +6417,7 @@ If you want to exclude refs from `refs/remotes`, use %OSTREE_REPO_LIST_REFS_EXT_EXCLUDE_REMOTES in @flags. Similarly use %OSTREE_REPO_LIST_REFS_EXT_EXCLUDE_MIRRORS to exclude refs from `refs/mirrors`. - + This function synchronously enumerates all commit objects starting + line="4573">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="4585">%TRUE on success, %FALSE on error, and @error will be set Repo + line="4575">Repo List commits starting with this checksum + line="4576">List commits starting with this checksum transfer-ownership="container"> + line="4577"> Map of serialized commit name to variant data @@ -6340,7 +6517,7 @@ Map of serialized commit name to variant data allow-none="1"> Cancellable + line="4579">Cancellable @@ -6350,7 +6527,7 @@ Map of serialized commit name to variant data throws="1"> This function synchronously enumerates all objects in the + line="4519">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. @@ -6358,20 +6535,20 @@ to #GVariant values of type %OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE. %TRUE on success, %FALSE on error, and @error will be set + line="4533">%TRUE on success, %FALSE on error, and @error will be set Repo + line="4521">Repo Flags controlling enumeration + line="4522">Flags controlling enumeration @@ -6381,7 +6558,7 @@ to #GVariant values of type %OSTREE_REPO_LIST_OBJECTS_VARIANT_TYPE. transfer-ownership="container"> + line="4523"> Map of serialized object name to variant data @@ -6394,7 +6571,7 @@ Map of serialized object name to variant data allow-none="1"> Cancellable + line="4525">Cancellable @@ -6517,6 +6694,47 @@ remote name) to checksums. Differently from ostree_repo_list_refs(), the + + This function synchronously enumerates all static delta indexes in the +repository, returning its result in @out_indexes. + + + + + + + Repo + + + + String name of delta indexes (checksum) + + + + + + Cancellable + + + + @@ -6562,7 +6780,7 @@ repository, returning its result in @out_deltas. throws="1"> A version of ostree_repo_load_variant() specialized to commits, + line="4495">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. @@ -6574,13 +6792,13 @@ means that only a sub-path of the commit is available. Repo + line="4497">Repo Commit checksum + line="4498">Commit checksum allow-none="1"> Commit + line="4499">Commit allow-none="1"> Commit state + line="4500">Commit state @@ -6610,7 +6828,7 @@ means that only a sub-path of the commit is available. Load content object, decomposing it into three parts: the actual + line="4005">Load content object, decomposing it into three parts: the actual content (for regular files), the metadata, and extended attributes. @@ -6620,13 +6838,13 @@ content (for regular files), the metadata, and extended attributes. Repo + line="4007">Repo ASCII SHA256 checksum + line="4008">ASCII SHA256 checksum allow-none="1"> File content + line="4009">File content allow-none="1"> File information + line="4010">File information allow-none="1"> Extended attributes + line="4011">Extended attributes allow-none="1"> Cancellable + line="4012">Cancellable @@ -6681,7 +6899,7 @@ content (for regular files), the metadata, and extended attributes. throws="1"> Load object as a stream; useful when copying objects between + line="4066">Load object as a stream; useful when copying objects between repositories. @@ -6691,19 +6909,19 @@ repositories. Repo + line="4068">Repo Object type + line="4069">Object type ASCII SHA256 checksum + line="4070">ASCII SHA256 checksum transfer-ownership="full"> Stream for object + line="4071">Stream for object transfer-ownership="full"> Length of @out_input + line="4072">Length of @out_input allow-none="1"> Cancellable + line="4073">Cancellable @@ -6740,7 +6958,7 @@ repositories. throws="1"> Load the metadata object @sha256 of type @objtype, storing the + line="4473">Load the metadata object @sha256 of type @objtype, storing the result in @out_variant. @@ -6750,19 +6968,19 @@ result in @out_variant. Repo + line="4475">Repo Expected object type + line="4476">Expected object type Checksum string + line="4477">Checksum string transfer-ownership="full"> Metadata object + line="4478">Metadata object @@ -6781,7 +6999,7 @@ result in @out_variant. throws="1"> Attempt to load the metadata object @sha256 of type @objtype if it + line="4450">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. @@ -6792,19 +7010,19 @@ exists, storing the result in @out_variant. If it doesn't exist, Repo + line="4452">Repo Object type + line="4453">Object type ASCII checksum + line="4454">ASCII checksum Metadata + line="4455">Metadata @@ -6824,7 +7042,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="2033">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. @@ -6839,19 +7057,19 @@ should use this if you are implementing a different type of transport. Repo + line="2035">Repo Commit SHA-256 + line="2036">Commit SHA-256 Whether or not this commit is partial + line="2037">Whether or not this commit is partial @@ -6862,7 +7080,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="1982">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 @@ -6877,25 +7095,25 @@ it. Repo + line="1984">Repo Commit SHA-256 + line="1985">Commit SHA-256 Whether or not this commit is partial + line="1986">Whether or not this commit is partial Reason bitmask for partial commit + line="1987">Reason bitmask for partial commit @@ -6922,7 +7140,7 @@ it. throws="1"> Starts or resumes a transaction. In order to write to a repo, you + line="1642">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(). @@ -6947,7 +7165,7 @@ active at a time. An #OstreeRepo + line="1644">An #OstreeRepo allow-none="1"> Whether this transaction + line="1645">Whether this transaction is resuming from a previous one. This is a legacy state, now OSTree pulls use per-commit `state/.commitpartial` files. @@ -6969,7 +7187,7 @@ pulls use per-commit `state/.commitpartial` files. allow-none="1"> Cancellable + line="1648">Cancellable @@ -6992,7 +7210,7 @@ statistics on objects that would be deleted, without actually deleting them. Locking: exclusive - + @@ -7072,7 +7290,7 @@ The %OSTREE_REPO_PRUNE_FLAGS_NO_PRUNE flag may be specified to just determine statistics on objects that would be deleted, without actually deleting them. Locking: exclusive - + @@ -7137,7 +7355,7 @@ targeting that commit; otherwise any static delta of non existing commits are deleted. Locking: exclusive - + @@ -7172,7 +7390,7 @@ non existing commit Connect to the remote repository, fetching the specified set of + line="4651">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. @@ -7188,7 +7406,7 @@ Warning: This API will iterate the thread default main context, which is a bug, but kept for compatibility reasons. If you want to avoid this, use g_main_context_push_thread_default() to push a new one around this call. - + @@ -7196,13 +7414,13 @@ one around this call. Repo + line="4653">Repo Name of remote + line="4654">Name of remote allow-none="1"> Optional list of refs; if %NULL, fetch all configured refs + line="4655">Optional list of refs; if %NULL, fetch all configured refs @@ -7219,7 +7437,7 @@ one around this call. Options controlling fetch behavior + line="4656">Options controlling fetch behavior allow-none="1"> Progress + line="4657">Progress allow-none="1"> Cancellable + line="4658">Cancellable @@ -7247,7 +7465,7 @@ one around this call. version="2018.6"> Pull refs from multiple remotes which have been found using + line="6255">Pull refs from multiple remotes which have been found using ostree_repo_find_remotes_async(). @results are expected to be in priority order, with the best remotes to pull @@ -7289,7 +7507,7 @@ The following @options are currently defined: not being pulled will be ignored and any ref without a keyring remote will be verified with the keyring of the remote being pulled from. Since: 2019.2 - + @@ -7297,13 +7515,13 @@ The following @options are currently defined: an #OstreeRepo + line="6257">an #OstreeRepo %NULL-terminated array of remotes to + line="6258">%NULL-terminated array of remotes to pull from, including the refs to pull from each @@ -7315,7 +7533,7 @@ The following @options are currently defined: allow-none="1"> A GVariant `a{sv}` with an extensible set of flags + line="6260">A GVariant `a{sv}` with an extensible set of flags an #OstreeAsyncProgress to update with the operation’s + line="6261">an #OstreeAsyncProgress to update with the operation’s progress, or %NULL @@ -7334,7 +7552,7 @@ The following @options are currently defined: allow-none="1"> a #GCancellable, or %NULL + line="6263">a #GCancellable, or %NULL asynchronous completion callback + line="6264">asynchronous completion callback data to pass to @callback + line="6265">data to pass to @callback @@ -7365,26 +7583,26 @@ The following @options are currently defined: throws="1"> Finish an asynchronous pull operation started with + line="6508">Finish an asynchronous pull operation started with ostree_repo_pull_from_remotes_async(). - + %TRUE on success, %FALSE otherwise + line="6517">%TRUE on success, %FALSE otherwise an #OstreeRepo + line="6510">an #OstreeRepo the asynchronous result + line="6511">the asynchronous result @@ -7394,9 +7612,9 @@ ostree_repo_pull_from_remotes_async(). throws="1"> This is similar to ostree_repo_pull(), but only fetches a single + line="4690">This is similar to ostree_repo_pull(), but only fetches a single subpath. - + @@ -7404,19 +7622,19 @@ subpath. Repo + line="4692">Repo Name of remote + line="4693">Name of remote Subdirectory path + line="4694">Subdirectory path allow-none="1"> Optional list of refs; if %NULL, fetch all configured refs + line="4695">Optional list of refs; if %NULL, fetch all configured refs @@ -7433,7 +7651,7 @@ subpath. Options controlling fetch behavior + line="4696">Options controlling fetch behavior allow-none="1"> Progress + line="4697">Progress allow-none="1"> Cancellable + line="4698">Cancellable @@ -7461,7 +7679,7 @@ subpath. throws="1"> Like ostree_repo_pull(), but supports an extensible set of flags. + line="3647">Like ostree_repo_pull(), but supports an extensible set of flags. The following are currently defined: * `refs` (`as`): Array of string refs @@ -7509,8 +7727,10 @@ The following are currently defined: the `summary` and `summary.sig` once for the entire transaction. If not specified, the `summary` will be downloaded from the remote. Since: 2020.5 * `summary-sig-bytes` (`ay`): Contents of the `summary.sig` file. If this - is specified, `summary-bytes` must also be specified. Since: 2020.5 - + is specified, `summary-bytes` must also be specified. Since: 2020.5 + * `disable-verify-bindings` (`b`): Disable verification of commit bindings. + Since: 2020.9 + @@ -7518,19 +7738,19 @@ The following are currently defined: Repo + line="3649">Repo Name of remote or file:// url + line="3650">Name of remote or file:// url A GVariant a{sv} with an extensible set of flags. + line="3651">A GVariant a{sv} with an extensible set of flags. Progress + line="3652">Progress Cancellable + line="3653">Cancellable @@ -7558,7 +7778,7 @@ The following are currently defined: throws="1"> Return the size in bytes of object with checksum @sha256, after any + line="4414">Return the size in bytes of object with checksum @sha256, after any compression has been applied. @@ -7568,19 +7788,19 @@ compression has been applied. Repo + line="4416">Repo Object type + line="4417">Object type Checksum + line="4418">Checksum transfer-ownership="full"> Size in bytes object occupies physically + line="4419">Size in bytes object occupies physically allow-none="1"> Cancellable + line="4420">Cancellable @@ -7608,7 +7828,7 @@ compression has been applied. throws="1"> Load the content for @rev into @out_root. + line="4616">Load the content for @rev into @out_root. @@ -7617,13 +7837,13 @@ compression has been applied. Repo + line="4618">Repo Ref or ASCII checksum + line="4619">Ref or ASCII checksum transfer-ownership="full"> An #OstreeRepoFile corresponding to the root + line="4620">An #OstreeRepoFile corresponding to the root transfer-ownership="full"> The resolved commit checksum + line="4621">The resolved commit checksum allow-none="1"> Cancellable + line="4622">Cancellable @@ -7660,7 +7880,7 @@ compression has been applied. throws="1"> OSTree commits can have arbitrary metadata associated; this + line="2975">OSTree commits can have arbitrary metadata associated; this function retrieves them. If none exists, @out_metadata will be set to %NULL. @@ -7671,13 +7891,13 @@ to %NULL. Repo + line="2977">Repo ASCII SHA256 commit checksum + line="2978">ASCII SHA256 commit checksum transfer-ownership="full"> Metadata associated with commit in with format "a{sv}", or %NULL if none exists + line="2979">Metadata associated with commit in with format "a{sv}", or %NULL if none exists allow-none="1"> Cancellable + line="2980">Cancellable @@ -7705,7 +7925,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 @@ -7723,7 +7943,7 @@ and refs in %OSTREE_SUMMARY_COLLECTION_MAP are guaranteed to be in lexicographic order. Locking: exclusive - + @@ -7731,7 +7951,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 @@ -7760,7 +7980,7 @@ Locking: exclusive throws="1"> By default, an #OstreeRepo will cache the remote configuration and its + line="3187">By default, an #OstreeRepo will cache the remote configuration and its own repo/config data. This API can be used to reload it. @@ -7770,7 +7990,7 @@ own repo/config data. This API can be used to reload it. repo + line="3189">repo allow-none="1"> cancellable + line="3190">cancellable @@ -7789,7 +8009,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="1651">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: @@ -7804,19 +8024,19 @@ mapped as follows: Repo + line="1653">Repo Name of remote + line="1654">Name of remote URL for remote (if URL begins with metalink=, it will be used as such) + line="1655">URL for remote (if URL begins with metalink=, it will be used as such) GVariant of type a{sv} + line="1656">GVariant of type a{sv} Cancellable + line="1657">Cancellable @@ -7844,7 +8064,7 @@ mapped as follows: throws="1"> A combined function handling the equivalent of + line="1839">A combined function handling the equivalent of ostree_repo_remote_add(), ostree_repo_remote_delete(), with more options. @@ -7855,7 +8075,7 @@ options. Repo + line="1841">Repo allow-none="1"> System root + line="1842">System root Operation to perform + line="1843">Operation to perform Name of remote + line="1844">Name of remote URL for remote (if URL begins with metalink=, it will be used as such) + line="1845">URL for remote (if URL begins with metalink=, it will be used as such) allow-none="1"> GVariant of type a{sv} + line="1846">GVariant of type a{sv} allow-none="1"> Cancellable + line="1847">Cancellable @@ -7910,7 +8130,7 @@ options. throws="1"> Delete the remote named @name. It is an error if the provided + line="1737">Delete the remote named @name. It is an error if the provided remote does not exist. @@ -7920,13 +8140,13 @@ remote does not exist. Repo + line="1739">Repo Name of remote + line="1740">Name of remote allow-none="1"> Cancellable + line="1741">Cancellable @@ -7945,7 +8165,7 @@ remote does not exist. throws="1"> Tries to fetch the summary file and any GPG signatures on the summary file + line="2332">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. @@ -7962,20 +8182,20 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string. %TRUE on success, %FALSE on failure + line="2357">%TRUE on success, %FALSE on failure Self + line="2334">Self name of a remote + line="2335">name of a remote allow-none="1"> return location for raw summary data, or + line="2336">return location for raw summary data, or %NULL @@ -7998,7 +8218,7 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string. allow-none="1"> return location for raw summary + line="2338">return location for raw summary signature data, or %NULL @@ -8008,7 +8228,7 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string. allow-none="1"> a #GCancellable + line="2340">a #GCancellable @@ -8019,7 +8239,7 @@ with #OSTREE_SUMMARY_GVARIANT_FORMAT as the format string. throws="1"> Like ostree_repo_remote_fetch_summary(), but supports an extensible set of flags. + line="6533">Like ostree_repo_remote_fetch_summary(), but supports an extensible set of flags. The following are currently defined: - override-url (s): Fetch summary from this URL if remote specifies no metalink in options @@ -8032,20 +8252,20 @@ The following are currently defined: %TRUE on success, %FALSE on failure + line="6555">%TRUE on success, %FALSE on failure Self + line="6535">Self name of a remote + line="6536">name of a remote A GVariant a{sv} with an extensible set of flags + line="6537">A GVariant a{sv} with an extensible set of flags return location for raw summary data, or + line="6538">return location for raw summary data, or %NULL @@ -8077,7 +8297,7 @@ The following are currently defined: allow-none="1"> return location for raw summary + line="6540">return location for raw summary signature data, or %NULL @@ -8087,7 +8307,7 @@ The following are currently defined: allow-none="1"> a #GCancellable + line="6542">a #GCancellable @@ -8097,27 +8317,27 @@ The following are currently defined: throws="1"> Return whether GPG verification is enabled for the remote named @name + line="2000">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="2011">%TRUE on success, %FALSE on failure Repo + line="2002">Repo Name of remote + line="2003">Name of remote allow-none="1"> Remote's GPG option + line="2004">Remote's GPG option @@ -8138,27 +8358,27 @@ not exist. throws="1"> Return whether GPG verification of the summary is enabled for the remote + line="2034">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="2045">%TRUE on success, %FALSE on failure Repo + line="2036">Repo Name of remote + line="2037">Name of remote allow-none="1"> Remote's GPG option + line="2038">Remote's GPG option @@ -8179,26 +8399,26 @@ remote does not exist. throws="1"> Return the URL of the remote named @name through @out_url. It is an + line="1957">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="1967">%TRUE on success, %FALSE on failure Repo + line="1959">Repo Name of remote + line="1960">Name of remote allow-none="1"> Remote's URL + line="1961">Remote's URL @@ -8219,31 +8439,31 @@ 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="2057">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. The imported keys will be used to conduct GPG verification when pulling from the remote named @name. - + %TRUE on success, %FALSE on failure + line="2076">%TRUE on success, %FALSE on failure Self + line="2059">Self name of a remote + line="2060">name of a remote allow-none="1"> a #GInputStream, or %NULL + line="2061">a #GInputStream, or %NULL allow-none="1"> a %NULL-terminated array of GPG key IDs, or %NULL + line="2062">a %NULL-terminated array of GPG key IDs, or %NULL @@ -8274,7 +8494,7 @@ from the remote named @name. allow-none="1"> return location for the number of imported + line="2063">return location for the number of imported keys, or %NULL @@ -8284,7 +8504,7 @@ from the remote named @name. allow-none="1"> a #GCancellable + line="2065">a #GCancellable @@ -8292,13 +8512,13 @@ from the remote named @name. List available remote names in an #OstreeRepo. Remote names are sorted + line="1906">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="1914">a %NULL-terminated array of remote names @@ -8308,7 +8528,7 @@ alphabetically. If no remotes are available the function returns %NULL. Repo + line="1908">Repo allow-none="1"> Number of remotes available + line="1909">Number of remotes available @@ -8502,7 +8722,7 @@ ostree_repo_resolve_rev_ext() but for collection-refs. throws="1"> Find the GPG keyring for the given @collection_id, using the local + line="1439">Find the GPG keyring for the given @collection_id, using the local configuration from the given #OstreeRepo. This will search the configured remotes for ones whose `collection-id` key matches @collection_id, and will return the first matching remote. @@ -8512,11 +8732,11 @@ be emitted, and the first result will be returned. It is expected that the keyrings should match. If no match can be found, a %G_IO_ERROR_NOT_FOUND error will be returned. - + #OstreeRemote containing the GPG keyring for + line="1457">#OstreeRemote containing the GPG keyring for @collection_id @@ -8524,13 +8744,13 @@ If no match can be found, a %G_IO_ERROR_NOT_FOUND error will be returned. an #OstreeRepo + line="1441">an #OstreeRepo the collection ID to look up a keyring for + line="1442">the collection ID to look up a keyring for allow-none="1"> a #GCancellable, or %NULL + line="1443">a #GCancellable, or %NULL @@ -8578,7 +8798,8 @@ find the given refspec in local. + transfer-ownership="full" + nullable="1"> A checksum,or %NULL if @allow_noent is true and it does not exist @@ -8632,7 +8853,8 @@ using it has no effect. + transfer-ownership="full" + nullable="1"> A checksum,or %NULL if @allow_noent is true and it does not exist @@ -8645,7 +8867,7 @@ using it has no effect. throws="1"> This function is deprecated in favor of using ostree_repo_devino_cache_new(), + line="1605">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()`. @@ -8670,7 +8892,7 @@ Multithreading: This function is *not* MT safe. An #OstreeRepo + line="1607">An #OstreeRepo allow-none="1"> Cancellable + line="1608">Cancellable @@ -8690,7 +8912,7 @@ Multithreading: This function is *not* MT safe. throws="1"> Like ostree_repo_set_ref_immediate(), but creates an alias. + line="2201">Like ostree_repo_set_ref_immediate(), but creates an alias. @@ -8699,7 +8921,7 @@ Multithreading: This function is *not* MT safe. An #OstreeRepo + line="2203">An #OstreeRepo allow-none="1"> A remote for the ref + line="2204">A remote for the ref The ref to write + line="2205">The ref to write allow-none="1"> The ref target to point it to, or %NULL to unset + line="2206">The ref target to point it to, or %NULL to unset allow-none="1"> GCancellable + line="2207">GCancellable @@ -8743,7 +8965,7 @@ Multithreading: This function is *not* MT safe. throws="1"> Set a custom location for the cache directory used for e.g. + line="3348">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. @@ -8755,19 +8977,19 @@ write permissions in the repo, where the cache is normally stored. An #OstreeRepo + line="3350">An #OstreeRepo directory fd + line="3351">directory fd subpath in @dfd + line="3352">subpath in @dfd allow-none="1"> a #GCancellable + line="3353">a #GCancellable @@ -8787,21 +9009,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="6238">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="6248">%TRUE on success, %FALSE otherwise an #OstreeRepo + line="6240">an #OstreeRepo allow-none="1"> new collection ID, or %NULL to unset it + line="6241">new collection ID, or %NULL to unset it @@ -8821,27 +9043,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="2227">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="2239">%TRUE on success, %FALSE otherwise An #OstreeRepo + line="2229">An #OstreeRepo The collection–ref to write + line="2230">The collection–ref to write allow-none="1"> The checksum to point it to, or %NULL to unset + line="2231">The checksum to point it to, or %NULL to unset allow-none="1"> GCancellable + line="2232">GCancellable @@ -8868,7 +9090,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="3331">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. @@ -8880,13 +9102,13 @@ ensuring data consistency. An #OstreeRepo + line="3333">An #OstreeRepo If %TRUE, do not fsync + line="3334">If %TRUE, do not fsync @@ -8896,7 +9118,7 @@ ensuring data consistency. throws="1"> This is like ostree_repo_transaction_set_ref(), except it may be + line="2173">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. @@ -8909,7 +9131,7 @@ Multithreading: This function is MT safe. An #OstreeRepo + line="2175">An #OstreeRepo allow-none="1"> A remote for the ref + line="2176">A remote for the ref The ref to write + line="2177">The ref to write allow-none="1"> The checksum to point it to, or %NULL to unset + line="2178">The checksum to point it to, or %NULL to unset allow-none="1"> GCancellable + line="2179">GCancellable @@ -8952,8 +9174,8 @@ Multithreading: This function is MT safe. throws="1"> Add a GPG signature to a commit. - + line="5018">Add a GPG signature to a commit. + @@ -8961,19 +9183,19 @@ Multithreading: This function is MT safe. Self + line="5020">Self SHA256 of given commit to sign + line="5021">SHA256 of given commit to sign Use this GPG key id + line="5022">Use this GPG key id allow-none="1"> GPG home directory, or %NULL + line="5023">GPG home directory, or %NULL allow-none="1"> A #GCancellable + line="5024">A #GCancellable @@ -9001,9 +9223,9 @@ Multithreading: This function is MT safe. throws="1"> This function is deprecated, sign the summary file instead. + line="5107">This function is deprecated, sign the summary file instead. Add a GPG signature to a static delta. - + @@ -9011,31 +9233,31 @@ Add a GPG signature to a static delta. Self + line="5109">Self From commit + line="5110">From commit To commit + line="5111">To commit key id + line="5112">key id homedir + line="5113">homedir allow-none="1"> cancellable + line="5114">cancellable @@ -9054,11 +9276,11 @@ Add a GPG signature to a static delta. throws="1"> Given a directory representing an already-downloaded static delta + line="630">Given a directory representing an already-downloaded static delta on disk, apply it, generating a new commit. The directory must be named with the form "FROM-TO", where both are checksums, and it must contain a file named "superblock", along with at least one part. - + @@ -9066,19 +9288,19 @@ must contain a file named "superblock", along with at least one part. Repo + line="632">Repo Path to a directory containing static delta data, or directly to the superblock + line="633">Path to a directory containing static delta data, or directly to the superblock If %TRUE, assume data integrity + line="634">If %TRUE, assume data integrity allow-none="1"> Cancellable + line="635">Cancellable @@ -9098,7 +9320,7 @@ must contain a file named "superblock", along with at least one part. throws="1"> Given a directory representing an already-downloaded static delta + line="390">Given a directory representing an already-downloaded static delta on disk, apply it, generating a new commit. If sign is passed, the static delta signature is verified. If sign-verify-deltas configuration option is set and static delta is signed, @@ -9106,7 +9328,7 @@ signature verification will be mandatory before apply the static delta. The directory must be named with the form "FROM-TO", where both are checksums, and it must contain a file named "superblock", along with at least one part. - + @@ -9114,25 +9336,25 @@ one part. Repo + line="392">Repo Path to a directory containing static delta data, or directly to the superblock + line="393">Path to a directory containing static delta data, or directly to the superblock Signature engine used to check superblock + line="394">Signature engine used to check superblock If %TRUE, assume data integrity + line="395">If %TRUE, assume data integrity allow-none="1"> Cancellable + line="396">Cancellable @@ -9170,7 +9392,7 @@ are known: - filename: ay: Save delta superblock to this filename, and parts in the same directory. Default saves to repository. - sign-name: ay: Signature type to use. - sign-key-ids: as: Array of keys used to sign delta superblock. - + @@ -9188,7 +9410,10 @@ are known: - + ASCII SHA256 checksum of origin, or %NULL @@ -9229,18 +9454,66 @@ are known: + + The delta index for a particular commit lists all the existing deltas that can be used +when downloading that commit. This operation regenerates these indexes, either for +a particular commit (if @opt_to_commit is non-%NULL), or for all commits that +are reachable by an existing delta (if @opt_to_commit is %NULL). + +This is normally called automatically when the summary is updated in ostree_repo_regenerate_summary(). + +Locking: shared + + + + + + + Repo + + + + Flags affecting the indexing operation + + + + ASCII SHA256 checksum of target commit, or %NULL to index all targets + + + + Cancellable + + + + Verify static delta file signature. - + line="1161">Verify static delta file signature. + TRUE if the signature of static delta file is valid using the + line="1171">TRUE if the signature of static delta file is valid using the signature engine provided, FALSE otherwise. @@ -9248,19 +9521,19 @@ signature engine provided, FALSE otherwise. Repo + line="1163">Repo delta path + line="1164">delta path Signature engine used to check superblock + line="1165">Signature engine used to check superblock allow-none="1"> success message + line="1166">success message @@ -9282,7 +9555,7 @@ signature engine provided, FALSE otherwise. version="2018.6"> If @checksum is not %NULL, then record it as the target of local ref named + line="2135">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 @@ -9302,13 +9575,13 @@ Multithreading: Since v2017.15 this function is MT safe. An #OstreeRepo + line="2137">An #OstreeRepo The collection–ref to write + line="2138">The collection–ref to write allow-none="1"> The checksum to point it to + line="2139">The checksum to point it to @@ -9326,7 +9599,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="2086">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. @@ -9355,7 +9628,7 @@ Multithreading: Since v2017.15 this function is MT safe. An #OstreeRepo + line="2088">An #OstreeRepo allow-none="1"> A remote for the ref + line="2089">A remote for the ref The ref to write + line="2090">The ref to write allow-none="1"> The checksum to point it to + line="2091">The checksum to point it to @@ -9388,7 +9661,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="2061">Like ostree_repo_transaction_set_ref(), but takes concatenated @refspec format as input instead of separate remote and name arguments. @@ -9401,13 +9674,13 @@ Multithreading: Since v2017.15 this function is MT safe. An #OstreeRepo + line="2063">An #OstreeRepo The refspec to write + line="2064">The refspec to write allow-none="1"> The checksum to point it to + line="2065">The checksum to point it to @@ -9428,7 +9701,7 @@ Multithreading: Since v2017.15 this function is MT safe. filename="ostree-repo-traverse.c" line="665">Create a new set @out_reachable containing all objects reachable from @commit_checksum, traversing @maxdepth parent commits. - + @@ -9482,7 +9755,7 @@ from @commit_checksum, traversing @maxdepth parent commits. filename="ostree-repo-traverse.c" line="639">Update the set @inout_reachable containing all objects reachable from @commit_checksum, traversing @maxdepth parent commits. - + @@ -9538,7 +9811,7 @@ from @commit_checksum, traversing @maxdepth parent commits. Additionally this constructs a mapping from each object to the parents of the object, which can be used to track which commits an object belongs to. - + @@ -9599,7 +9872,7 @@ belongs to. line="307">Add all commit objects directly reachable via a ref to @reachable. Locking: shared - + @@ -9641,26 +9914,26 @@ Locking: shared throws="1"> Check for a valid GPG signature on commit named by the ASCII + line="5496">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="5508">%TRUE if there was a GPG signature from a trusted keyring, otherwise %FALSE Repository + line="5498">Repository ASCII SHA256 checksum + line="5499">ASCII SHA256 checksum allow-none="1"> Path to directory GPG keyrings; overrides built-in default if given + line="5500">Path to directory GPG keyrings; overrides built-in default if given allow-none="1"> Path to additional keyring file (not a directory) + line="5501">Path to additional keyring file (not a directory) allow-none="1"> Cancellable + line="5502">Cancellable @@ -9697,26 +9970,26 @@ checksum @commit_checksum. throws="1"> Read GPG signature(s) on the commit named by the ASCII checksum + line="5534">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="5546">an #OstreeGpgVerifyResult, or %NULL on error Repository + line="5536">Repository ASCII SHA256 checksum + line="5537">ASCII SHA256 checksum allow-none="1"> Path to directory GPG keyrings; overrides built-in default if given + line="5538">Path to directory GPG keyrings; overrides built-in default if given allow-none="1"> Path to additional keyring file (not a directory) + line="5539">Path to additional keyring file (not a directory) - - Cancellable - - - - - - 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 - - - - - Repository - - - - ASCII SHA256 checksum - - - - OSTree remote to use for configuration - - - Verify @signatures for @summary data using GPG keys in the keyring for -@remote_name, and return an #OstreeGpgVerifyResult. - + line="5570">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="5582">an #OstreeGpgVerifyResult, or %NULL on error Repo + line="5572">Repository + + + + ASCII SHA256 checksum + + + + OSTree remote to use for configuration + + + + Cancellable + + + + + + Verify @signatures for @summary data using GPG keys in the keyring for +@remote_name, and return an #OstreeGpgVerifyResult. + + + an #OstreeGpgVerifyResult, or %NULL on error + + + + + Repo Name of remote + line="5660">Name of remote Summary data as a #GBytes + line="5661">Summary data as a #GBytes Summary signatures as a #GBytes + line="5662">Summary signatures as a #GBytes allow-none="1"> Cancellable + line="5663">Cancellable @@ -9849,7 +10122,7 @@ configured for @remote. throws="1"> Import an archive file @archive into the repository, and write its + line="968">Import an archive file @archive into the repository, and write its file structure to @mtree. @@ -9859,19 +10132,19 @@ file structure to @mtree. An #OstreeRepo + line="970">An #OstreeRepo A path to an archive file + line="971">A path to an archive file The #OstreeMutableTree to write to + line="972">The #OstreeMutableTree to write to allow-none="1"> Optional commit modifier + line="973">Optional commit modifier Autocreate parent directories + line="974">Autocreate parent directories allow-none="1"> Cancellable + line="975">Cancellable @@ -9906,7 +10179,7 @@ file structure to @mtree. throws="1"> Read an archive from @fd and import it into the repository, writing + line="1003">Read an archive from @fd and import it into the repository, writing its file structure to @mtree. @@ -9916,19 +10189,19 @@ its file structure to @mtree. An #OstreeRepo + line="1005">An #OstreeRepo A file descriptor to read the archive from + line="1006">A file descriptor to read the archive from The #OstreeMutableTree to write to + line="1007">The #OstreeMutableTree to write to allow-none="1"> Optional commit modifier + line="1008">Optional commit modifier Autocreate parent directories + line="1009">Autocreate parent directories allow-none="1"> Cancellable + line="1010">Cancellable @@ -9963,7 +10236,7 @@ its file structure to @mtree. throws="1"> Write a commit metadata object, referencing @root_contents_checksum + line="2889">Write a commit metadata object, referencing @root_contents_checksum and @root_metadata_checksum. @@ -9973,7 +10246,7 @@ and @root_metadata_checksum. Repo + line="2891">Repo allow-none="1"> ASCII SHA256 checksum for parent, or %NULL for none + line="2892">ASCII SHA256 checksum for parent, or %NULL for none allow-none="1"> Subject + line="2893">Subject allow-none="1"> Body + line="2894">Body allow-none="1"> GVariant of type a{sv}, or %NULL for none + line="2895">GVariant of type a{sv}, or %NULL for none The tree to point the commit to + line="2896">The tree to point the commit to transfer-ownership="full"> Resulting ASCII SHA256 checksum for commit + line="2897">Resulting ASCII SHA256 checksum for commit allow-none="1"> Cancellable + line="2898">Cancellable @@ -10043,7 +10316,7 @@ and @root_metadata_checksum. throws="1"> Replace any existing metadata associated with commit referred to by + line="3023">Replace any existing metadata associated with commit referred to by @checksum with @metadata. If @metadata is %NULL, then existing data will be deleted. @@ -10054,13 +10327,13 @@ data will be deleted. Repo + line="3025">Repo ASCII SHA256 commit checksum + line="3026">ASCII SHA256 commit checksum allow-none="1"> Metadata to associate with commit in with format "a{sv}", or %NULL to delete + line="3027">Metadata to associate with commit in with format "a{sv}", or %NULL to delete allow-none="1"> Cancellable + line="3028">Cancellable @@ -10088,7 +10361,7 @@ data will be deleted. throws="1"> Write a commit metadata object, referencing @root_contents_checksum + line="2921">Write a commit metadata object, referencing @root_contents_checksum and @root_metadata_checksum. @@ -10098,7 +10371,7 @@ and @root_metadata_checksum. Repo + line="2923">Repo allow-none="1"> ASCII SHA256 checksum for parent, or %NULL for none + line="2924">ASCII SHA256 checksum for parent, or %NULL for none allow-none="1"> Subject + line="2925">Subject allow-none="1"> Body + line="2926">Body allow-none="1"> GVariant of type a{sv}, or %NULL for none + line="2927">GVariant of type a{sv}, or %NULL for none The tree to point the commit to + line="2928">The tree to point the commit to The time to use to stamp the commit + line="2929">The time to use to stamp the commit transfer-ownership="full"> Resulting ASCII SHA256 checksum for commit + line="2930">Resulting ASCII SHA256 checksum for commit allow-none="1"> Cancellable + line="2931">Cancellable @@ -10174,7 +10447,7 @@ and @root_metadata_checksum. throws="1"> Save @new_config in place of this repository's config file. + line="1463">Save @new_config in place of this repository's config file. @@ -10183,13 +10456,13 @@ and @root_metadata_checksum. Repo + line="1465">Repo Overwrite the config file with this data + line="1466">Overwrite the config file with this data @@ -10199,7 +10472,7 @@ and @root_metadata_checksum. throws="1"> Store the content object streamed as @object_input, + line="2714">Store the content object streamed as @object_input, with total length @length. The actual checksum will be returned as @out_csum. @@ -10210,7 +10483,7 @@ be returned as @out_csum. Repo + line="2716">Repo allow-none="1"> If provided, validate content against this checksum + line="2717">If provided, validate content against this checksum Content object stream + line="2718">Content object stream Length of @object_input + line="2719">Length of @object_input allow-none="1"> Binary checksum + line="2720">Binary checksum @@ -10253,7 +10526,7 @@ be returned as @out_csum. allow-none="1"> Cancellable + line="2721">Cancellable @@ -10262,7 +10535,7 @@ be returned as @out_csum. c:identifier="ostree_repo_write_content_async"> Asynchronously store the content object @object. If provided, the + line="2812">Asynchronously store the content object @object. If provided, the checksum @expected_checksum will be verified. @@ -10272,7 +10545,7 @@ checksum @expected_checksum will be verified. Repo + line="2814">Repo allow-none="1"> If provided, validate content against this checksum + line="2815">If provided, validate content against this checksum Input + line="2816">Input Length of @object + line="2817">Length of @object allow-none="1"> Cancellable + line="2818">Cancellable closure="5"> Invoked when content is writed + line="2819">Invoked when content is writed allow-none="1"> User data for @callback + line="2820">User data for @callback @@ -10332,7 +10605,7 @@ checksum @expected_checksum will be verified. throws="1"> Completes an invocation of ostree_repo_write_content_async(). + line="2853">Completes an invocation of ostree_repo_write_content_async(). @@ -10341,13 +10614,13 @@ checksum @expected_checksum will be verified. a #OstreeRepo + line="2855">a #OstreeRepo a #GAsyncResult + line="2856">a #GAsyncResult transfer-ownership="full"> A binary SHA256 checksum of the content object + line="2857">A binary SHA256 checksum of the content object @@ -10366,7 +10639,7 @@ checksum @expected_checksum will be verified. throws="1"> Store the content object streamed as @object_input, with total + line="2687">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 @@ -10379,25 +10652,25 @@ disk, for example. Repo + line="2689">Repo Store content using this ASCII SHA256 checksum + line="2690">Store content using this ASCII SHA256 checksum Content stream + line="2691">Content stream Length of @object_input + line="2692">Length of @object_input allow-none="1"> Cancellable + line="2693">Cancellable @@ -10416,7 +10689,7 @@ disk, for example. throws="1"> Store as objects all contents of the directory referred to by @dfd + line="3978">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. @@ -10427,25 +10700,25 @@ resulting filesystem hierarchy into @mtree. Repo + line="3980">Repo Directory file descriptor + line="3981">Directory file descriptor Path + line="3982">Path Overlay directory contents into this tree + line="3983">Overlay directory contents into this tree allow-none="1"> Optional modifier + line="3984">Optional modifier @@ -10464,7 +10737,7 @@ resulting filesystem hierarchy into @mtree. allow-none="1"> Cancellable + line="3985">Cancellable @@ -10474,7 +10747,7 @@ resulting filesystem hierarchy into @mtree. throws="1"> Store objects for @dir and all children into the repository @self, + line="3937">Store objects for @dir and all children into the repository @self, overlaying the resulting filesystem hierarchy into @mtree. @@ -10484,19 +10757,19 @@ overlaying the resulting filesystem hierarchy into @mtree. Repo + line="3939">Repo Path to a directory + line="3940">Path to a directory Overlay directory contents into this tree + line="3941">Overlay directory contents into this tree allow-none="1"> Optional modifier + line="3942">Optional modifier @@ -10515,7 +10788,7 @@ overlaying the resulting filesystem hierarchy into @mtree. allow-none="1"> Cancellable + line="3943">Cancellable @@ -10525,7 +10798,7 @@ overlaying the resulting filesystem hierarchy into @mtree. throws="1"> Store the metadata object @object. Return the checksum + line="2417">Store the metadata object @object. Return the checksum as @out_csum. If @expected_checksum is not %NULL, verify it against the @@ -10538,13 +10811,13 @@ computed checksum. Repo + line="2419">Repo Object type + line="2420">Object type allow-none="1"> If provided, validate content against this checksum + line="2421">If provided, validate content against this checksum Metadata + line="2422">Metadata allow-none="1"> Binary checksum + line="2423">Binary checksum @@ -10581,7 +10854,7 @@ computed checksum. allow-none="1"> Cancellable + line="2424">Cancellable @@ -10590,7 +10863,7 @@ computed checksum. c:identifier="ostree_repo_write_metadata_async"> Asynchronously store the metadata object @variant. If provided, + line="2596">Asynchronously store the metadata object @variant. If provided, the checksum @expected_checksum will be verified. @@ -10600,13 +10873,13 @@ the checksum @expected_checksum will be verified. Repo + line="2598">Repo Object type + line="2599">Object type allow-none="1"> If provided, validate content against this checksum + line="2600">If provided, validate content against this checksum Metadata + line="2601">Metadata allow-none="1"> Cancellable + line="2602">Cancellable closure="5"> Invoked when metadata is writed + line="2603">Invoked when metadata is writed allow-none="1"> Data for @callback + line="2604">Data for @callback @@ -10660,7 +10933,7 @@ the checksum @expected_checksum will be verified. throws="1"> Complete a call to ostree_repo_write_metadata_async(). + line="2637">Complete a call to ostree_repo_write_metadata_async(). @@ -10669,13 +10942,13 @@ the checksum @expected_checksum will be verified. Repo + line="2639">Repo Result + line="2640">Result transfer-ownership="full"> Binary checksum value + line="2641">Binary checksum value @@ -10696,7 +10969,7 @@ the checksum @expected_checksum will be verified. throws="1"> Store the metadata object @variant; the provided @checksum is + line="2494">Store the metadata object @variant; the provided @checksum is trusted. @@ -10706,31 +10979,31 @@ trusted. Repo + line="2496">Repo Object type + line="2497">Object type Store object with this ASCII SHA256 checksum + line="2498">Store object with this ASCII SHA256 checksum Metadata object stream + line="2499">Metadata object stream Length, may be 0 for unknown + line="2500">Length, may be 0 for unknown allow-none="1"> Cancellable + line="2501">Cancellable @@ -10749,7 +11022,7 @@ trusted. throws="1"> Store the metadata object @variant; the provided @checksum is + line="2531">Store the metadata object @variant; the provided @checksum is trusted. @@ -10759,25 +11032,25 @@ trusted. Repo + line="2533">Repo Object type + line="2534">Object type Store object with this ASCII SHA256 checksum + line="2535">Store object with this ASCII SHA256 checksum Metadata object + line="2536">Metadata object allow-none="1"> Cancellable + line="2537">Cancellable @@ -10796,7 +11069,7 @@ trusted. throws="1"> Write all metadata objects for @mtree to repo; the resulting + line="4028">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. @@ -10807,13 +11080,13 @@ the @mtree represented. Repo + line="4030">Repo Mutable tree + line="4031">Mutable tree transfer-ownership="full"> An #OstreeRepoFile representing @mtree's root. + line="4032">An #OstreeRepoFile representing @mtree's root. allow-none="1"> Cancellable + line="4033">Cancellable @@ -10842,7 +11115,7 @@ the @mtree represented. transfer-ownership="none"> Path to repository. Note that if this repository was created + line="1125">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 @@ -10856,7 +11129,7 @@ use file-descriptor relative operations. transfer-ownership="none"> Path to directory containing remote definitions. The default is `NULL`. + line="1158">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`. @@ -10869,7 +11142,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="1140">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. @@ -10881,7 +11154,7 @@ object via `ostree_sysroot_repo()`. Emitted during a pull operation upon GPG verification (if enabled). + line="1176">Emitted during a pull operation upon GPG verification (if enabled). Applications can connect to this signal to output the verification results if desired. @@ -10895,13 +11168,13 @@ is called. checksum of the signed object + line="1179">checksum of the signed object an #OstreeGpgVerifyResult + line="1180">an #OstreeGpgVerifyResult @@ -11234,7 +11507,7 @@ ostree_repo_checkout_tree(). - + @@ -11266,14 +11539,14 @@ ostree_repo_checkout_tree(). A new commit modifier. + line="4116">A new commit modifier. Control options for filter + line="4111">Control options for filter @@ -11286,7 +11559,7 @@ ostree_repo_checkout_tree(). destroy="3"> Function that can inspect individual files + line="4112">Function that can inspect individual files allow-none="1"> User data + line="4113">User data scope="async"> A #GDestroyNotify + line="4114">A #GDestroyNotify @@ -11325,7 +11598,7 @@ ostree_repo_checkout_tree(). version="2017.13"> See the documentation for + line="4267">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. @@ -11343,14 +11616,14 @@ should avoid further mutation of the cache. Modifier + line="4269">Modifier A hash table caching device,inode to checksums + line="4270">A hash table caching device,inode to checksums @@ -11359,7 +11632,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="4189">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 @@ -11375,7 +11648,7 @@ policy wins. An #OstreeRepoCommitModifier + line="4191">An #OstreeRepoCommitModifier @@ -11385,7 +11658,7 @@ policy wins. allow-none="1"> Policy to use for labeling + line="4192">Policy to use for labeling @@ -11396,7 +11669,7 @@ policy wins. throws="1"> In many cases, one wants to create a "derived" commit from base commit. + line="4211">In many cases, one wants to create a "derived" commit from base commit. SELinux policy labels are part of that base commit. This API allows one to easily set up SELinux labeling from a base commit. @@ -11407,20 +11680,20 @@ one to easily set up SELinux labeling from a base commit. Commit modifier + line="4213">Commit modifier OSTree repo containing @rev + line="4214">OSTree repo containing @rev Find SELinux policy from this base commit + line="4215">Find SELinux policy from this base commit c:identifier="ostree_repo_commit_modifier_set_xattr_callback"> If set, this function should return extended attributes to use for + line="4166">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. @@ -11447,7 +11720,7 @@ repository. An #OstreeRepoCommitModifier + line="4168">An #OstreeRepoCommitModifier @@ -11458,14 +11731,14 @@ repository. destroy="1"> Function to be invoked, should return extended attributes for path + line="4169">Function to be invoked, should return extended attributes for path Destroy notification + line="4170">Destroy notification allow-none="1"> Data for @callback: + line="4171">Data for @callback: @@ -11605,7 +11878,7 @@ by ostree_repo_load_commit(). - + @@ -11613,7 +11886,7 @@ by ostree_repo_load_commit(). - + @@ -11629,7 +11902,7 @@ by ostree_repo_load_commit(). - + @@ -11647,7 +11920,7 @@ by ostree_repo_load_commit(). line="235">Return information on the current directory. This function may only be called if %OSTREE_REPO_COMMIT_ITER_RESULT_DIR was returned from ostree_repo_commit_traverse_iter_next(). - + @@ -11695,7 +11968,7 @@ from ostree_repo_commit_traverse_iter_next(). line="214">Return information on the current file. This function may only be called if %OSTREE_REPO_COMMIT_ITER_RESULT_FILE was returned from ostree_repo_commit_traverse_iter_next(). - + @@ -11733,7 +12006,7 @@ ostree_repo_commit_traverse_iter_next(). Initialize (in place) an iterator over the root of a commit object. - + @@ -11772,7 +12045,7 @@ ostree_repo_commit_traverse_iter_next(). Initialize (in place) an iterator over a directory tree. - + @@ -11822,7 +12095,7 @@ ostree_repo_commit_traverse_iter_get_file(). If %OSTREE_REPO_COMMIT_ITER_RESULT_ERROR is returned, it is a program error to call any further API on @iter except for ostree_repo_commit_traverse_iter_clear(). - + @@ -11848,7 +12121,7 @@ ostree_repo_commit_traverse_iter_clear(). - + @@ -13336,31 +13609,31 @@ possible modes. - + No special options for pruning + line="1211">No special options for pruning Don't actually delete objects + line="1212">Don't actually delete objects Do not traverse individual commit objects, only follow refs + line="1213">Do not traverse individual commit objects, only follow refs - + @@ -13387,46 +13660,46 @@ possible modes. - + No special options for pull + line="1270">No special options for pull Write out refs suitable for mirrors and fetch all refs if none requested + line="1271">Write out refs suitable for mirrors and fetch all refs if none requested Fetch only the commit metadata + line="1272">Fetch only the commit metadata Do verify checksums of local (filesystem-accessible) repositories (defaults on for HTTP) + line="1273">Do verify checksums of local (filesystem-accessible) repositories (defaults on for HTTP) Since 2017.7. Reject writes of content objects with modes outside of 0775. + line="1274">Since 2017.7. Reject writes of content objects with modes outside of 0775. Don't verify checksums of objects HTTP repositories (Since: 2017.12) + line="1275">Don't verify checksums of objects HTTP repositories (Since: 2017.12) @@ -15422,21 +15695,35 @@ Based on ostree_repo_add_gpg_signature_summary implementation. c:type="OstreeStaticDeltaGenerateOpt"> Parameters controlling optimization of static deltas. - + line="1055">Parameters controlling optimization of static deltas. + Optimize for speed of delta creation over space + line="1057">Optimize for speed of delta creation over space Optimize for delta size (may be very slow) + line="1058">Optimize for delta size (may be very slow) + + + + Flags controlling static delta index generation. + + + No special flags Create a new #OstreeSysroot object for the sysroot at @path. If @path is %NULL, + line="204">Create a new #OstreeSysroot object for the sysroot at @path. If @path is %NULL, the current visible root file system is used, equivalent to ostree_sysroot_new_default(). An accessor object for an system root located at @path + line="213">An accessor object for an system root located at @path @@ -15465,7 +15752,7 @@ ostree_sysroot_new_default(). allow-none="1"> Path to a system root directory, or %NULL to use the + line="206">Path to a system root directory, or %NULL to use the current visible root file system @@ -15477,24 +15764,24 @@ ostree_sysroot_new_default(). An accessor for the current visible root / filesystem + line="224">An accessor for the current visible root / filesystem - + Path to deployment origin file + line="1343">Path to deployment origin file A deployment path + line="1341">A deployment path @@ -15504,7 +15791,7 @@ ostree_sysroot_new_default(). filename="ostree-sysroot-cleanup.c" line="543">Delete any state that resulted from a partially completed transaction, such as incomplete deployments. - + @@ -15541,7 +15828,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 - + @@ -15602,8 +15889,8 @@ Locking: exclusive throws="1"> Older version of ostree_sysroot_stage_tree_with_options(). - + line="2855">Older version of ostree_sysroot_stage_tree_with_options(). + @@ -15611,7 +15898,7 @@ Locking: exclusive Sysroot + line="2857">Sysroot allow-none="1"> osname to use for merge deployment + line="2858">osname to use for merge deployment Checksum to add + line="2859">Checksum to add allow-none="1"> Origin to use for upgrades + line="2860">Origin to use for upgrades allow-none="1"> Use this deployment for merge path + line="2861">Use this deployment for merge path allow-none="1"> Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment + line="2862">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment @@ -15664,7 +15951,7 @@ Locking: exclusive transfer-ownership="full"> The new deployment path + line="2863">The new deployment path allow-none="1"> Cancellable + line="2864">Cancellable @@ -15684,12 +15971,12 @@ Locking: exclusive throws="1"> Check out deployment tree with revision @revision, performing a 3 + line="2808">Check out deployment tree with revision @revision, performing a 3 way merge with @provided_merge_deployment for configuration. When booted into the sysroot, you should use the ostree_sysroot_stage_tree() API instead. - + @@ -15697,7 +15984,7 @@ ostree_sysroot_stage_tree() API instead. Sysroot + line="2810">Sysroot allow-none="1"> osname to use for merge deployment + line="2811">osname to use for merge deployment Checksum to add + line="2812">Checksum to add allow-none="1"> Origin to use for upgrades + line="2813">Origin to use for upgrades allow-none="1"> Use this deployment for merge path + line="2814">Use this deployment for merge path allow-none="1"> Options + line="2815">Options @@ -15749,7 +16036,7 @@ ostree_sysroot_stage_tree() API instead. transfer-ownership="full"> The new deployment path + line="2816">The new deployment path allow-none="1"> Cancellable + line="2817">Cancellable @@ -15768,9 +16055,9 @@ ostree_sysroot_stage_tree() API instead. throws="1"> Entirely replace the kernel arguments of @deployment with the + line="3278">Entirely replace the kernel arguments of @deployment with the values in @new_kargs. - + @@ -15778,19 +16065,19 @@ values in @new_kargs. Sysroot + line="3280">Sysroot A deployment + line="3281">A deployment Replace deployment's kernel arguments + line="3282">Replace deployment's kernel arguments @@ -15801,7 +16088,7 @@ values in @new_kargs. allow-none="1"> Cancellable + line="3283">Cancellable @@ -15811,10 +16098,10 @@ values in @new_kargs. throws="1"> By default, deployment directories are not mutable. This function + line="3327">By default, deployment directories are not mutable. This function will allow making them temporarily mutable, for example to allow layering additional non-OSTree content. - + @@ -15822,19 +16109,19 @@ layering additional non-OSTree content. Sysroot + line="3329">Sysroot A deployment + line="3330">A deployment Whether or not deployment's files can be changed + line="3331">Whether or not deployment's files can be changed allow-none="1"> Cancellable + line="3332">Cancellable @@ -15854,7 +16141,7 @@ layering additional non-OSTree content. throws="1"> By default, deployments may be subject to garbage collection. Typical uses of + line="2206">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 @@ -15863,7 +16150,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). - + @@ -15871,19 +16158,19 @@ the staged deployment (as it's not in the bootloader entries). Sysroot + line="2208">Sysroot A deployment + line="2209">A deployment Whether or not deployment will be automatically GC'd + line="2210">Whether or not deployment will be automatically GC'd @@ -15894,13 +16181,13 @@ the staged deployment (as it's not in the bootloader entries). throws="1"> Configure the target deployment @deployment such that it + line="2000">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. - + @@ -15908,19 +16195,19 @@ across reboots. Sysroot + line="2002">Sysroot Deployment + line="2003">Deployment Transition to this unlocked state + line="2004">Transition to this unlocked state @@ -15930,7 +16217,7 @@ across reboots. allow-none="1"> Cancellable + line="2005">Cancellable @@ -15940,7 +16227,7 @@ across reboots. throws="1"> Ensure that @self is set up as a valid rootfs, by creating + line="425">Ensure that @self is set up as a valid rootfs, by creating /ostree/repo, among other things. @@ -15950,7 +16237,7 @@ across reboots. Sysroot + line="427">Sysroot allow-none="1"> Cancellable + line="428">Cancellable @@ -15967,17 +16254,17 @@ across reboots. - + The currently booted deployment, or %NULL if none + line="1239">The currently booted deployment, or %NULL if none Sysroot + line="1237">Sysroot @@ -15996,24 +16283,24 @@ across reboots. - + Path to deployment root directory + line="1329">Path to deployment root directory Sysroot + line="1326">Sysroot A deployment + line="1327">A deployment @@ -16022,27 +16309,27 @@ across reboots. c:identifier="ostree_sysroot_get_deployment_dirpath"> Note this function only returns a *relative* path - if you want + line="1303">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="1312">Path to deployment root directory, relative to sysroot Repo + line="1305">Repo A deployment + line="1306">A deployment @@ -16053,7 +16340,7 @@ or concatenate it with the full ostree_sysroot_get_path(). Ordered list of deployments + line="1290">Ordered list of deployments @@ -16062,7 +16349,7 @@ or concatenate it with the full ostree_sysroot_get_path(). Sysroot + line="1288">Sysroot @@ -16070,21 +16357,21 @@ or concatenate it with the full ostree_sysroot_get_path(). Access a file descriptor that refers to the root directory of this sysroot. + line="361">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="369">A file descriptor valid for the lifetime of @self Sysroot + line="363">Sysroot @@ -16093,20 +16380,20 @@ prior to calling this function. c:identifier="ostree_sysroot_get_merge_deployment"> Find the deployment to use as a configuration merge source; this is + line="1555">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="1563">Configuration merge deployment Sysroot + line="1557">Sysroot allow-none="1"> Operating system group + line="1558">Operating system group @@ -16125,11 +16412,14 @@ the first one in the current deployment list which matches osname. Path to rootfs + line="263">Path to rootfs + Sysroot @@ -16139,20 +16429,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="1354">Retrieve the OSTree repository in sysroot @self. The repo is guaranteed to be open (see ostree_repo_open()). - + %TRUE on success, %FALSE otherwise + line="1364">%TRUE on success, %FALSE otherwise Sysroot + line="1356">Sysroot allow-none="1"> Repository in sysroot @self + line="1357">Repository in sysroot @self allow-none="1"> Cancellable + line="1358">Cancellable @@ -16180,18 +16470,18 @@ the first one in the current deployment list which matches osname. - - + + The currently staged deployment, or %NULL if none + line="1274">The currently staged deployment, or %NULL if none Sysroot + line="1272">Sysroot @@ -16214,10 +16504,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="1751">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. - + @@ -16225,13 +16515,13 @@ is required for generating a deployment. Sysroot + line="1753">Sysroot Name group of operating system checkouts + line="1754">Name group of operating system checkouts allow-none="1"> Cancellable + line="1755">Cancellable @@ -16251,7 +16541,7 @@ is required for generating a deployment. throws="1"> Subset of ostree_sysroot_load(); performs basic initialization. Notably, one + line="954">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 @@ -16264,7 +16554,7 @@ invoked. sysroot + line="956">sysroot @@ -16274,19 +16564,19 @@ invoked. version="2020.1"> Can only be invoked after `ostree_sysroot_initialize()`. + line="378">Can only be invoked after `ostree_sysroot_initialize()`. %TRUE iff the sysroot points to a booted deployment + line="384">%TRUE iff the sysroot points to a booted deployment Sysroot + line="380">Sysroot @@ -16294,7 +16584,7 @@ invoked. Load deployment list, bootversion, and subbootversion from the + line="910">Load deployment list, bootversion, and subbootversion from the rootfs @self. @@ -16304,7 +16594,7 @@ rootfs @self. Sysroot + line="912">Sysroot allow-none="1"> Cancellable + line="913">Cancellable @@ -16330,7 +16620,7 @@ rootfs @self. #OstreeSysroot + line="1169">#OstreeSysroot allow-none="1"> Cancellable + line="1171">Cancellable @@ -16353,13 +16643,13 @@ rootfs @self. Acquire an exclusive multi-process write lock for @self. This call + line="1605">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. - + @@ -16367,7 +16657,7 @@ be released if @self is deallocated. Self + line="1607">Self @@ -16375,8 +16665,8 @@ be released if @self is deallocated. An asynchronous version of ostree_sysroot_lock(). - + line="1715">An asynchronous version of ostree_sysroot_lock(). + @@ -16384,7 +16674,7 @@ be released if @self is deallocated. Self + line="1717">Self allow-none="1"> Cancellable + line="1718">Cancellable closure="2"> Callback + line="1719">Callback allow-none="1"> User data + line="1720">User data @@ -16423,8 +16713,8 @@ be released if @self is deallocated. throws="1"> Call when ostree_sysroot_lock_async() is ready. - + line="1734">Call when ostree_sysroot_lock_async() is ready. + @@ -16432,37 +16722,37 @@ be released if @self is deallocated. Self + line="1736">Self Result + line="1737">Result - + A new config file which sets @refspec as an origin + line="1594">A new config file which sets @refspec as an origin Sysroot + line="1591">Sysroot A refspec + line="1592">A refspec @@ -16474,7 +16764,7 @@ be released if @self is deallocated. filename="ostree-sysroot-cleanup.c" line="560">Like ostree_sysroot_cleanup() in that it cleans up incomplete deployments and old boot versions, but does NOT prune the repository. - + @@ -16501,12 +16791,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="1498">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. - + @@ -16514,7 +16804,7 @@ we're not looking at the booted deployment. Sysroot + line="1500">Sysroot allow-none="1"> "stateroot" name + line="1501">"stateroot" name The pending deployment + line="1502">The pending deployment The rollback deployment + line="1503">The rollback deployment @@ -16553,21 +16845,44 @@ we're not looking at the booted deployment. This function is a variant of ostree_sysroot_get_repo() that cannot fail, and + line="1379">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="1387">The OSTree repository in sysroot @self. Sysroot + line="1381">Sysroot + + + + + + Find the booted deployment, or return an error if not booted via OSTree. + + + The currently booted deployment, or an error + + + + + Sysroot @@ -16577,7 +16892,7 @@ or ostree_sysroot_load() has been invoked successfully. version="2020.1"> If this function is invoked, then libostree will assume that + line="232">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. @@ -16604,7 +16919,7 @@ be invoked before or after ostree_sysroot_initialize(). throws="1"> Prepend @new_deployment to the list of deployments, commit, and + line="1815">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. @@ -16626,7 +16941,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. - + @@ -16634,7 +16949,7 @@ later, instead. Sysroot + line="1817">Sysroot allow-none="1"> OS name + line="1818">OS name Prepend this deployment to the list + line="1819">Prepend this deployment to the list allow-none="1"> Use this deployment for configuration merge + line="1820">Use this deployment for configuration merge Flags controlling behavior + line="1821">Flags controlling behavior @@ -16674,7 +16989,7 @@ later, instead. allow-none="1"> Cancellable + line="1822">Cancellable @@ -16685,10 +17000,10 @@ later, instead. throws="1"> Stage an overlay initrd to be used in an upcoming deployment. Returns a checksum which + line="2947">Stage an overlay initrd to be used in an upcoming deployment. Returns a checksum which can be passed to ostree_sysroot_deploy_tree_with_options() or ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option. - + @@ -16696,13 +17011,13 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option. Sysroot + line="2949">Sysroot File descriptor to overlay initrd + line="2950">File descriptor to overlay initrd Overlay initrd checksum + line="2951">Overlay initrd checksum Cancellable + line="2952">Cancellable @@ -16731,8 +17046,8 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option. throws="1"> Older version of ostree_sysroot_stage_tree_with_options(). - + line="3004">Older version of ostree_sysroot_stage_tree_with_options(). + @@ -16740,7 +17055,7 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option. Sysroot + line="3006">Sysroot osname to use for merge deployment + line="3007">osname to use for merge deployment Checksum to add + line="3008">Checksum to add Origin to use for upgrades + line="3009">Origin to use for upgrades Use this deployment for merge path + line="3010">Use this deployment for merge path Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment + line="3011">Use these as kernel arguments; if %NULL, inherit options from provided_merge_deployment @@ -16793,7 +17108,7 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option. transfer-ownership="full"> The new deployment path + line="3012">The new deployment path Cancellable + line="3013">Cancellable @@ -16813,9 +17128,9 @@ ostree_sysroot_stage_tree_with_options() via the `overlay_initrds` array option. throws="1"> Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS + line="3038">Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS shutdown time. - + @@ -16823,7 +17138,7 @@ shutdown time. Sysroot + line="3040">Sysroot allow-none="1"> osname to use for merge deployment + line="3041">osname to use for merge deployment Checksum to add + line="3042">Checksum to add allow-none="1"> Origin to use for upgrades + line="3043">Origin to use for upgrades allow-none="1"> Use this deployment for merge path + line="3044">Use this deployment for merge path Options + line="3045">Options @@ -16872,7 +17187,7 @@ shutdown time. transfer-ownership="full"> The new deployment path + line="3046">The new deployment path allow-none="1"> Cancellable + line="3047">Cancellable @@ -16891,14 +17206,14 @@ shutdown time. throws="1"> Try to acquire an exclusive multi-process write lock for @self. If + line="1631">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. - + @@ -16906,7 +17221,7 @@ be released if @self is deallocated. Self + line="1633">Self transfer-ownership="full"> Whether or not the lock has been acquired + line="1634">Whether or not the lock has been acquired @@ -16923,7 +17238,7 @@ be released if @self is deallocated. Release any resources such as file descriptors referring to the + line="407">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. @@ -16937,7 +17252,7 @@ This undoes the effect of `ostree_sysroot_load()`. Sysroot + line="409">Sysroot @@ -16945,10 +17260,10 @@ This undoes the effect of `ostree_sysroot_load()`. Clear the lock previously acquired with ostree_sysroot_lock(). It + line="1679">Clear the lock previously acquired with ostree_sysroot_lock(). It is safe to call this function if the lock has not been previously acquired. - + @@ -16956,7 +17271,7 @@ acquired. Self + line="1681">Self @@ -16966,9 +17281,9 @@ acquired. throws="1"> Older version of ostree_sysroot_write_deployments_with_options(). This + line="2227">Older version of ostree_sysroot_write_deployments_with_options(). This version will perform post-deployment cleanup by default. - + @@ -16976,13 +17291,13 @@ version will perform post-deployment cleanup by default. Sysroot + line="2229">Sysroot List of new deployments + line="2230">List of new deployments @@ -16993,7 +17308,7 @@ version will perform post-deployment cleanup by default. allow-none="1"> Cancellable + line="2231">Cancellable @@ -17004,13 +17319,13 @@ version will perform post-deployment cleanup by default. throws="1"> Assuming @new_deployments have already been deployed in place on disk via + line="2357">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. - + @@ -17018,13 +17333,13 @@ if for example you want to control pruning of the repository. Sysroot + line="2359">Sysroot List of new deployments + line="2360">List of new deployments @@ -17032,7 +17347,7 @@ if for example you want to control pruning of the repository. Options + line="2361">Options @@ -17042,7 +17357,7 @@ if for example you want to control pruning of the repository. allow-none="1"> Cancellable + line="2362">Cancellable @@ -17052,10 +17367,10 @@ if for example you want to control pruning of the repository. throws="1"> Immediately replace the origin file of the referenced @deployment + line="953">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. - + @@ -17063,13 +17378,13 @@ this function will write the current origin of @deployment. System root + line="955">System root Deployment + line="956">Deployment allow-none="1"> Origin content + line="957">Origin content allow-none="1"> Cancellable + line="958">Cancellable @@ -17101,7 +17416,7 @@ this function will write the current origin of @deployment. libostree will log to the journal various events, such as the /etc merge + line="164">libostree will log to the journal various events, such as the /etc merge status, and transaction completion. Connect to this signal to also synchronously receive the text for those messages. This is intended to be used by command line tools which link to libostree as a library. @@ -17114,14 +17429,14 @@ Currently, the structured data is only available via the systemd journal. Human-readable string (should not contain newlines) + line="167">Human-readable string (should not contain newlines) - + @@ -17146,7 +17461,7 @@ Currently, the structured data is only available via the systemd journal. - + @@ -17625,7 +17940,7 @@ from inside the tree such as package databases. - + @@ -17698,7 +18013,7 @@ users who had been using zero before. + + #OstreeBloom is an implementation of a bloom filter which supports writing to +and loading from a #GBytes bit array. The caller must store metadata about +the bloom filter (its hash function and `k` parameter value) separately, as +the same values must be used when reading from a serialised bit array as were +used to build the array in the first place. + +This is a standard implementation of a bloom filter, and background reading +on the theory can be +[found on Wikipedia](https://en.wikipedia.org/wiki/Bloom_filter). In +particular, a bloom filter is parameterised by `m` and `k` parameters: the +size of the bit array (in bits) is `m`, and the number of hash functions +applied to each element is `k`. Bloom filters require a universal hash +function which can be parameterised by `k`. We have #OstreeBloomHashFunc, +with ostree_str_bloom_hash() being an implementation for strings. + +The serialised output from a bloom filter is guaranteed to be stable across +versions of libostree as long as the same values for `k` and the hash +function are used. + +#OstreeBloom is mutable when constructed with ostree_bloom_new(), and elements +can be added to it using ostree_bloom_add_element(), until ostree_bloom_seal() +is called to serialise it and make it immutable. After then, the bloom filter +can only be queried using ostree_bloom_maybe_contains(). + +If constructed with ostree_bloom_new_from_bytes(), the bloom filter is +immutable from construction, and can only be queried. + +Reference: + - https://en.wikipedia.org/wiki/Bloom_filter + - https://llimllib.github.io/bloomfilter-tutorial/ + %TRUE if current libostree has at least the requested version, %FALSE otherwise + line="2734">%TRUE if current libostree has at least the requested version, %FALSE otherwise Major/year required + line="2731">Major/year required Release version required + line="2732">Release version required @@ -18482,7 +18831,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="2415">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. @@ -18497,14 +18846,14 @@ root "dirmeta" checksum (both in binary form, not hexadecimal). A SHA-256 hex string, or %NULL if @commit_variant is not well-formed + line="2431">A SHA-256 hex string, or %NULL if @commit_variant is not well-formed A commit object + line="2417">A commit object @@ -18515,7 +18864,7 @@ root "dirmeta" checksum (both in binary form, not hexadecimal). throws="1"> Reads a commit's "ostree.sizes" metadata and returns an array of + line="2589">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 @@ -18528,7 +18877,7 @@ returned. variant of type %OSTREE_OBJECT_TYPE_COMMIT + line="2591">variant of type %OSTREE_OBJECT_TYPE_COMMIT allow-none="1"> + line="2592"> return location for an array of object size entries @@ -18552,7 +18901,7 @@ returned. Checksum of the parent commit of @commit_variant, or %NULL + line="2386">Checksum of the parent commit of @commit_variant, or %NULL if none @@ -18560,7 +18909,7 @@ if none Variant of type %OSTREE_OBJECT_TYPE_COMMIT + line="2384">Variant of type %OSTREE_OBJECT_TYPE_COMMIT @@ -18572,18 +18921,50 @@ if none timestamp in seconds since the Unix epoch, UTC + line="2403">timestamp in seconds since the Unix epoch, UTC Commit object + line="2401">Commit object + + Update provided @dict with standard metadata for bootable OSTree commits. + + + + + + + Root filesystem to be committed + + + + Dictionary to update + + + + + + + @@ -19271,6 +19652,264 @@ only valid for the lifetime of @variant, and must not be freed. + + For many asynchronous operations, it's desirable for callers to be +able to watch their status as they progress. For example, an user +interface calling an asynchronous download operation will want to +be able to see the total number of bytes downloaded. + +This class provides a mechanism for callees of asynchronous +operations to communicate back with callers. It transparently +handles thread safety, ensuring that the progress change +notification occurs in the thread-default context of the calling +operation. + +The ostree_async_progress_get_status() and ostree_async_progress_set_status() +methods get and set a well-known `status` key of type %G_VARIANT_TYPE_STRING. +This key may be accessed using the other #OstreeAsyncProgress methods, but it +must always have the correct type. + + + These functions implement repository-independent algorithms for +operating on the core OSTree data formats, such as converting +#GFileInfo into a #GVariant. + +There are 4 types of objects; file, dirmeta, tree, and commit. The +last 3 are metadata, and the file object is the only content object +type. + +All metadata objects are stored as #GVariant (big endian). The +rationale for this is the same as that of the ext{2,3,4} family of +filesystems; most developers will be using LE, and so it's better +to continually test the BE->LE swap. + +The file object is a custom format in order to support streaming. + + + #OstreeGpgVerifyResult contains verification details for GPG signatures +read from a detached #OstreeRepo metadata object. + +Use ostree_gpg_verify_result_count_all() and +ostree_gpg_verify_result_count_valid() to quickly check overall signature +validity. + +Use ostree_gpg_verify_result_lookup() to find a signature by the key ID +or fingerprint of the signing key. + +For more in-depth inspection, such as presenting signature details to the +user, pass an array of attribute values to ostree_gpg_verify_result_get() +or get all signature details with ostree_gpg_verify_result_get_all(). + + + An implementation of #GConverter that compresses data using +LZMA. + + + An implementation of #GConverter that decompresses data using +LZMA. + + + In order to commit content into an #OstreeRepo, it must first be +imported into an #OstreeMutableTree. There are several high level +APIs to create an initiable #OstreeMutableTree from a physical +filesystem directory, but they may also be computed +programmatically. + + + The #OstreeRepo is like git, a content-addressed object store. +Unlike git, it records uid, gid, and extended attributes. + +There are four possible "modes" for an #OstreeRepo; %OSTREE_REPO_MODE_BARE +is very simple - content files are represented exactly as they are, and +checkouts are just hardlinks. %OSTREE_REPO_MODE_BARE_USER is similar, except +the uid/gids are not set on the files, and checkouts as hardlinks work only +for user checkouts. %OSTREE_REPO_MODE_BARE_USER_ONLY is the same as +BARE_USER, but all metadata is not stored, so it can only be used for user +checkouts. This mode does not require xattrs. A %OSTREE_REPO_MODE_ARCHIVE +(also known as %OSTREE_REPO_MODE_ARCHIVE_Z2) repository in contrast stores +content files zlib-compressed. It is suitable for non-root-owned +repositories that can be served via a static HTTP server. + +Creating an #OstreeRepo does not invoke any file I/O, and thus needs +to be initialized, either from existing contents or as a new +repository. If you have an existing repo, use ostree_repo_open() +to load it from disk and check its validity. To initialize a new +repository in the given filepath, use ostree_repo_create() instead. + +To store content in the repo, first start a transaction with +ostree_repo_prepare_transaction(). Then create a +#OstreeMutableTree, and apply functions such as +ostree_repo_write_directory_to_mtree() to traverse a physical +filesystem and write content, possibly multiple times. + +Once the #OstreeMutableTree is complete, write all of its metadata +with ostree_repo_write_mtree(), and finally create a commit with +ostree_repo_write_commit(). + +## Collection IDs + +A collection ID is a globally unique identifier which, if set, is used to +identify refs from a repository which are mirrored elsewhere, such as in +mirror repositories or peer to peer networks. + +This is separate from the `collection-id` configuration key for a remote, which +is used to store the collection ID of the repository that remote points to. + +The collection ID should only be set on an #OstreeRepo if it is the canonical +collection for some refs. + +A collection ID must be a reverse DNS name, where the domain name is under the +control of the curator of the collection, so they can demonstrate ownership +of the collection. The later elements in the reverse DNS name can be used to +disambiguate between multiple collections from the same curator. For example, +`org.exampleos.Main` and `org.exampleos.Apps`. For the complete format of +collection IDs, see ostree_validate_collection_id(). + + + #OstreeRepoFinderAvahi is an implementation of #OstreeRepoFinder which looks +for refs being hosted by peers on the local network. + +Any ref which matches by collection ID and ref name is returned as a result, +with no limitations on the peers which host them, as long as they are +accessible over the local network, and their adverts reach this machine via +DNS-SD/mDNS. + +For each repository which is found, a result will be returned for the +intersection of the refs being searched for, and the refs in `refs/mirrors` +in the remote repository. + +DNS-SD resolution is performed using Avahi, which will continue to scan for +matching peers throughout the lifetime of the process. It’s recommended that +ostree_repo_finder_avahi_start() be called early on in the process’ lifetime, +and the #GMainContext which is passed to ostree_repo_finder_avahi_new() +continues to be iterated until ostree_repo_finder_avahi_stop() is called. + +The values stored in DNS-SD TXT records are stored as big-endian whenever +endianness is relevant. + +Internally, #OstreeRepoFinderAvahi has an Avahi client, browser and resolver +which work in the background to track all available peers on the local +network. Whenever a resolve request is made using +ostree_repo_finder_resolve_async(), the request is blocked until the +background tracking is in a consistent state (typically this only happens at +startup), and is then answered using the current cache of background data. +The Avahi client tracks the #OstreeRepoFinderAvahi’s connection with the +Avahi D-Bus service. The browser looks for DNS-SD peers on the local network; +and the resolver is used to retrieve information about services advertised by +each peer, including the services’ TXT records. + + + #OstreeRepoFinderConfig is an implementation of #OstreeRepoFinder which looks +refs up in locally configured remotes and returns remote URIs. +Duplicate remote URIs are combined into a single #OstreeRepoFinderResult +which lists multiple refs. + +For all the locally configured remotes which have an `collection-id` specified +(see [ostree.repo-config(5)](man:ostree.repo-config(5))), it finds the +intersection of their refs and the set of refs to resolve. If the +intersection is non-empty, that remote is returned as a result. Remotes which +do not have their `collection-id` key configured are ignored. + + + #OstreeRepoFinderMount is an implementation of #OstreeRepoFinder which looks +refs up in well-known locations on any mounted removable volumes. + +For each mounted removable volume, the directory `.ostree/repos.d` will be +enumerated, and all OSTree repositories below it will be searched, in lexical +order, for the requested #OstreeCollectionRefs. The names of the directories +below `.ostree/repos.d` are irrelevant, apart from their lexical ordering. +The directories `.ostree/repo`, `ostree/repo` and `var/lib/flatpak/repo` +will be searched after the others, if they exist. +Non-removable volumes are ignored. + +For each repository which is found, a result will be returned for the +intersection of the refs being searched for, and the refs in `refs/heads` and +`refs/mirrors` in the repository on the removable volume. + +Symlinks are followed when listing the repositories, so a volume might +contain a single OSTree at some arbitrary path, with a symlink from +`.ostree/repos.d`. Any symlink which points outside the volume’s file +system will be ignored. Repositories are deduplicated in the results. + +The volume monitor used to find mounted volumes can be overridden by setting +#OstreeRepoFinderMount:monitor. By default, g_volume_monitor_get() is used. + + + #OstreeRepoFinderOverride is an implementation of #OstreeRepoFinder which +looks refs up in a list of remotes given by their URI, and returns the URIs +which contain the refs. Duplicate remote URIs are combined into a single +#OstreeRepoFinderResult which lists multiple refs. + +Each result is given an #OstreeRepoFinderResult.priority value of 20, which +ranks its results above those from the other default #OstreeRepoFinder +implementations. + +Results can only be returned for a ref if a remote and keyring are configured +locally for the collection ID of that ref, otherwise there would be no keys +available to verify signatures on commits for that ref. + +This is intended to be used for user-provided overrides and testing software +which uses #OstreeRepoFinder. For production use, #OstreeRepoFinderConfig is +recommended instead. + + + A #OstreeSePolicy object can load the SELinux policy from a given +root and perform labeling. + + + An #OstreeSign interface allows to select and use any available engine +for signing or verifying the commit object or summary file. + + + A #OstreeSysroot object represents a physical root filesystem, +which in particular should contain a toplevel /ostree directory. +Inside this directory is an #OstreeRepo in /ostree/repo, plus a set +of deployments in /ostree/deploy. + +This class is not by default safe against concurrent use by threads +or external processes. You can use ostree_sysroot_lock() to +perform locking externally. + + + The #OstreeSysrootUpgrader class allows performing simple upgrade +operations. + + + ostree provides macros to check the version of the library +at compile-time + @@ -19504,10 +20143,23 @@ for writing data to an #OstreeRepo. + + The #OstreeRemote structure represents the configuration for a single remote +repository. Currently, all configuration is handled internally, and +#OstreeRemote objects are represented by their textual name handle, or by an +opaque pointer (which can be reference counted if needed). + +#OstreeRemote provides configuration for accessing a remote, but does not +provide the results of accessing a remote, such as information about what +refs are currently on a remote, or the commits they currently point to. Use +#OstreeRepo in combination with an #OstreeRemote to query that information. + - + @@ -19678,6 +20330,24 @@ signing engines; they will not be initialized. + + libsoup contains several help methods for processing HTML forms as +defined by <ulink +url="http://www.w3.org/TR/html401/interact/forms.html#h-17.13">the +HTML 4.01 specification</ulink>. + + + A #SoupURI represents a (parsed) URI. + +Many applications will not need to use #SoupURI directly at all; on +the client side, soup_message_new() takes a stringified URI, and on +the server side, the path and query components are provided for you +in the server callback. + @@ -19785,14 +20455,14 @@ Valid collection IDs are reverse DNS names: %TRUE if @checksum is a valid ASCII SHA256 checksum + line="2078">%TRUE if @checksum is a valid ASCII SHA256 checksum an ASCII string + line="2075">an ASCII string @@ -19802,20 +20472,20 @@ Valid collection IDs are reverse DNS names: throws="1"> Use this to validate the basic structure of @commit, independent of + line="2200">Use this to validate the basic structure of @commit, independent of any other objects it references. %TRUE if @commit is structurally valid + line="2208">%TRUE if @commit is structurally valid A commit object, %OSTREE_OBJECT_TYPE_COMMIT + line="2202">A commit object, %OSTREE_OBJECT_TYPE_COMMIT @@ -19827,14 +20497,14 @@ any other objects it references. %TRUE if @checksum is a valid binary SHA256 checksum + line="2064">%TRUE if @checksum is a valid binary SHA256 checksum a #GVariant of type "ay" + line="2061">a #GVariant of type "ay" @@ -19844,19 +20514,19 @@ any other objects it references. throws="1"> Use this to validate the basic structure of @dirmeta. + line="2352">Use this to validate the basic structure of @dirmeta. %TRUE if @dirmeta is structurally valid + line="2359">%TRUE if @dirmeta is structurally valid A dirmeta object, %OSTREE_OBJECT_TYPE_DIR_META + line="2354">A dirmeta object, %OSTREE_OBJECT_TYPE_DIR_META @@ -19866,20 +20536,20 @@ any other objects it references. throws="1"> Use this to validate the basic structure of @dirtree, independent of + line="2240">Use this to validate the basic structure of @dirtree, independent of any other objects it references. %TRUE if @dirtree is structurally valid + line="2248">%TRUE if @dirtree is structurally valid A dirtree object, %OSTREE_OBJECT_TYPE_DIR_TREE + line="2242">A dirtree object, %OSTREE_OBJECT_TYPE_DIR_TREE @@ -19891,14 +20561,14 @@ any other objects it references. %TRUE if @mode represents a valid file type and permissions + line="2337">%TRUE if @mode represents a valid file type and permissions A Unix filesystem mode + line="2334">A Unix filesystem mode @@ -19910,7 +20580,7 @@ any other objects it references. %TRUE if @objtype represents a valid object type + line="2046">%TRUE if @objtype represents a valid object type